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PREFACE 
TIMEX COMPUTER CORPORATION has made every effort possible to insure that 
inaccuracies or discrepancies do not exist within our manuals or software. 


Our aim is to provide each user with a top-quality and reliable product. 


However, we assume no liability for the misuse or misapplication of our 
manuals or systems or for inaccuracies or omissions within our manuals or 


programs. 


Please note that the specifications in this manual are subject to change 


without prior notice. 


This manual may not be reproduced, in whole or in part, without the express 


written consent of TIMEX COMPUTER CORPORATION. 


For additional information regarding our products and/or services contact 
TIMEX CORPORATION, P.0.BOX 2655, WATERBURY, CONNECTICUT 06725; PHONE 
1-800-24-TIMEX. 
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' INTRODUCTION 
~ INTRODUCTION 
PURPOSE OF MANUAL 


The TIMEX Sinclair 2000 persona] Computer is a full-feature personal 
color-computer. Developed from the Sinclair Spectrum, the T/S 2000 has many 
features that are not available on the Spectrum. These include joysticks, 
3-channel sound synthesis, bank Switching, Cartridge-software Support, a 
function dispatcher, additional commands, etc, 


The operating system within the T/S 2000 is a derivative of the one that the 
Spectrum uses. The addresses of any useful routines in the Spectrum ROM have 
Changed. These routines, and others are available through the function 
dispatcher. 


The purpose of this manual is two-fold. First, it-will enable the veteran 
Spectrum Programmer to convert his Spectrum Programs to a form runable on the 
T/S 2000. It will also permit him to add functions to his programs that take 


accepted, 


HOW TO USE THIS MANUAL 


The organization of this manual makes it easy to find the information you 
need. To locate Particular subject matter, use the Table of Contents to 
determine the Page on which the information appears. 


Read this reference manual before attempting to write or submit software for 
TIMEX evaluation. Sufficient familiarity with the contents of this manual 
Will help to Structure your Program in the recommended manner. In addition, 
this manual should be used with the SPECTRUM manual as a guide to the T/S 2000 
computer. ; 
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REVISION PROTOCOL 


Periodically, new documentation is released to inform the user of revised 
procedures or product enhancements, etc. This documentation may take the form 
of revised manuals, change pages, or technical bulletins. 


When change pages are received, immediately remove and discard the old pages 
and substitute the new ones. If it is necessary to issue an entirely new 
page, the page number will be followed by a letter in alpha sequence (e.g. 
2-4a). In this instance, insert the additional page into your manual (e.g. 
between pages 2-4 and 2-5). A mark on the right-hand margin of the new page 
will indicate the place, line, or paragraph, where the documentation has been 
changed. Additionally, the date of the change will be found on the lower 
right-hand corner of the changed page. 


Technical bulletins, which are sequentially numbered, should be kept in the 
binder with your manual. 


Following this technique will insure that your manual is always up-to-date. 
QUERIES 


Should you have any questions regarding the contents of this manual, please 
direct your comments to TIMEX. 


viii 


1.1 INTRODUCTION 


SECTION I deals with the memory of the T/S 2000. 
map, bank switching, 


SECTION I 
MEMORY 


SECTION I: 
MEMORY 


It covers the system memory 
the bank switching controller chip, the Home Bank 


layout, the ROS bank layout, AROS/LROS, and expansion Banks. 


1.2 SYSTEM MEMORY 


The system memory is configured as illustrated by Figure 1-1. 


RAM 





Home ROM 


Home ROM 


HOME BANK 


ot NO PhP OAQN 





EXROM BANK 


Figure 1-1. 


Unused (2) 





DOCK BANK 


SYSTEM MEMORY MAP 


RAM/ROM 

RAM/ROM 
[_Rawnow | 
[_RAW7ROM |) 


EXPANSION BANK 


[1] ROM contains the T/S 2000 System Software enhancements. 


[2] Home Bank Chunk #3 is permanently enabled to provide interrupt handling 


and a stack. 


1-1 


SECTION I: 
MEMORY 


1.3 BANK SWITCHING 


Since the T/S 2000 is a Z-80 based computer and can only address 64K of memory 
directly, a bank selection mechanism is provided. Memory is selected in 8K 
"Chunks" which are identified by bank number (horizontal index) and Chunk 
number (vertical index), as illustrated by Figure 1-2. 


The Home Bank is the bank which is selected by default, other banks must be 
explicitly selected. All banks are identified by a number, @ - 255. Bank 
‘0 is an AROS and/or LROS (i.e. DOCK Bank), banks 1 through 253 are 
peripherals, bank 254 is the Home ROM Extension, (i.e.. EXROM Bank) and bank 
255 is the Home Bank. Bank selection services are provided by the system 
software (refer to Section VI). The following paragraphs will describe the 
architecture of the banks in the system. 





EXROM BANK (254). EXPANSION BANKS (1-253) 


HOME BANK (255) DOCK BANK (0) 


Figure 1-2. SYSTEM MEMORY ARCHITECTURE 


The memory space on the TS 2000 consists of a 64K Home Bank, a 64K DOCK Bank, 
an 8K EXROM Bank and a plurality of 64K Expansion Banks. The memory map is 
shown in Figure 1-1. Each 64K bank is divided into eight 8K "Chunks". The 
T/S 2000 hardware provides an ability to enable eight Chunks under software 
control which determine the actual 64K address space of the Z80 at any one 
time. At most one Chunk along the horizontal axis may be enabled at any one 
time (i.e., if Chunk #1 is enabled in the DOCK Bank, it must/will be disabled 
in all other banks). Details of the software control of bank switching are 
contained in paragraph 6.9. 
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yada! 


The Home Bank has the lowest priority, thus its 
Chunks are enabled by default when no other bank 
has the same Chunks enabled. The DOCK Bank has 
the next highest Priority, thus its Chunks are 
enabled when no expansion Bank has the same Chunks 
enabled. The expansion Banks have the highest 
priority. The Home ROM Extension Bank (EXROM). has 
the same priority as the DOCK Bank. 


1.3.1 Reserved Chunks 


Note that the machine stack, function dispatcher and bank Switching 
communication facilities must always be available to the system. These 
routines will always be in either Chunk 3 or Chunk 7 of the Home Bank. One of 
these Chunks must always be enabled. The one that must be enabled is the one 
that contains the code listed above. 

A system variable called VIDMOD (location 23741) determines where these blocks 
of code are at any given time. If VIDMOD is zero, then they are in Chunk 3. 
If VIDMOD is non-zero, then they are in Chunk 7. These routines are moved up 
to Chunk 7 if the secondary display file (D_FILE 2) is requested for use, 


If you are operating a 16K machine, then these routines will always be in 
Chunk 3 because there is no memory to hold them in Chunk 7. 


Whichever Chunk or Chunks are utilized to hold these essential routines, 
it/they should always be enabled within the Home Bank (i.e. disabled in the 
DOCK Bank and all Expansion Banks). Thus, Chunk.3 (and/or 7 if the second 
display file is used) should not be enabled in any bank other than the Home 
Bank. 


1.4 BANK SWITCHING CONTROL 


The bank switching communication services access the bank switching hardware 
by reading and writing to the following I/0 ports: 


; DKHSPT = F4H: DOCK horizontal select port 

- BDATPT = FCH: Expansion Bank "data" port 

- BCMDPT = FDH: Expansion Bank "address" port 

- HREXPT = FFH: Home ROM Extension select port (bit 7) 


These ports read from and/or write to the following bank switching hardware 
registers: 


- DKHSPT writes to: DOCK horizontal select register 


-  BDATPT writes to: Registers 9-3 : 
- BCMDPT writes to: Address register (selects registers §-3) 
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a MEMORY 
In addition there are the following registers: 
- HOLD : Temporary holding register 
- ABN : Assigned bank number register (one for each Expansion Bank ) 
- BNA : Bank number accessed register 
« HS : Expansion Bank horizontal select register (one for each 


Expansion Bank) : 
STATUS : Status nybble whose bits have the following interpretation: 


bit @ - Set to @ if bank caused an interrupt (maskable) 

bit 1 - Not used 

bit 2 - Set to @ if bank-is responding to memory 
read/write ; 

bit 3 - Not used 


The bank switching controller chip uses a four-bit data path (Dg-D3). 


The DOCK horizontal select register specifies which of the DOCK Bank Chunks 
are enabled (active high). The hold register is used to latch data in and out 
of the ABN, BNA, and HS registers. The BNA register contains the bank number 
of the bank whose status is currently being changed or queried. There is only 
one hold register and one BNA register. There are ABN and HS registers for 
each expansion Bank. The ABN register contains the bank number assigned to a 
particular bank. The HS register specifies which Chunks in the expansion 
Banks are currently enabled (active high). 


The DOCK horizontal select port accesses the DOCK horizontal select register. 
This port is both read from and written to. The expansion Bank “address” port 
is used to specify which register to write to, or read from. The "data" port 
is used to read/write data to the designated register within the bank 
switching controller. The addresses are listed in Table 1-1.. 


Table 1-1 
EXPANSION BANK CONTROLLER REGISTERS 


| ADDRESS ss] READ DATA POR 


Read status 
None 

Read HS 1s nybble 
Read HS ms _nybble 




















Write cmd 1s -nybble - 
Write cmd ms nybble 
Write hold reg. 1s nybble 
Write hold reg. ms nybble 





The two command (cmd) ports have the functions listed in Table 1-2. 
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MEMORY 
Table 1-2 ; 
CMD REGISTER FUNCTIONS 
Command -- Least-significant nybble 7/0 
BIT. ACTIVE FUNCTION 
ie LOW Reset controller -- prepare for initialization 
113 LOW Start interrupt REG sequence. 
2 |i LOW Initialization done. Move to next bank in 
daisy chain. 
ac] LOW Reset interrupt flag. 


Command -- Most 


p ‘LOW 
] LOW 
2 LOW » 
3 


1.5 HOME BANK LAYOUT 


Significant nybble 


Dump hold REG to ABN. 
Dump hold REG to BNA. 
Dump hold REG to HS. 
Not used. 


Area 2 is a 16K Home ROM which 


The Home Bank is illustrated by Figure 1-3. 


contains: a) a BASIC interpreter, b) 


input and output (display text and graphics, 


the sound chip and joysticks), and c) 


a set of routines which provide basic 
keyboard input, printer, access to 
channeled I/0 to dumb devices or 


intelligent devices both of which may be attached to the Expansion Bus. Area 1 


is the Home RAM (either 16K or 48K) 


which contains the Display Files, System 


Variables, BASIC Program, etc. 


Area bracketed in text refers to 
its counterpart in the illustration. 










8000H 
cern 7BOOH 
£000 7800H 
OR SECONDARY 
cooo DISPLAY 
Hee A000 va apie FILE 
C1) BANK SWITCH 6000H 
8000 6000H 
~ 16K SYSVARDS 5BOOH 
RAM 4 6000 A-FILE 1 5800H 
1 
C1] 4000 eee 
DISPLA 
16K 
ROM 2000 FILE 
D-FILE 1 
C2] ( cove S090 





Figure 1-3. HOME BANK ARCHITECTURE 
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1.6 EXROM BANK LAYOUT 


The Home Bank has associated with it an 8K ROM. This ROM together with the 
16K ROM make up 24K of System ROM. The 8K ROM is located in a separate bank 
called the EXROM Bank. (This 8K ROM is called the EXROM.) Contained within 
the ROM are: the cassette tape I/0 routines, the bank switching code, and the 
system initialization routines. 


This ROM is accessed by a software switch. Bit 7 of 1/0 address FFhex 
designates the selection status of the EXROM. If this bit is set, the EXROM 
Will overlay.the lowest 8K Chunk (Chunk g) in the DOCK Bank. 


Thus, to access this ROM, you must set bit 7 in port FFhex, and set at least 
bit @ in the DHS register (1/0 port F4h). You must also insure that no 
external banks have their first Chunk selected, as external banks have higher 
priority than the DOCK Bank and would override the system's access to the DOCK 
Bank, and thus the EXROM. 


1.7 ROM ORIENTED SOFTWARE (ROS): AROS/LROS 


A connector is present on the T/S 2000 base unit and on each Bus Expansion 
Unit (BEU) (refer to paragraph 1.9.1) to allow the plug-in of ROM Oriented 
Software. The ROS component may be one of two types or both: 


1. Application ROM Oriented Software (AROS), and 
2. Language ROM Oriented Software (LROS). 


The AROS contains an application program which eliminates the cassette loading 
step and makes all of the system RAM available for data. The LROS allows the 
T/S 2000 to take on a personality other than that of the BASIC programming 
language (i.e.; other languages such as LOGO, etc.). The system software's 
architecture supports the ability of both an AROS and an LROS to be used at 
the same time. 


It should be noted that both the AROS and the LROS share the same 56K of 
address space. An individual ROS may use up all or part of that 56K of space 
(the DOCK Bank). If LROS and AROS are to be used simultaneously, their 
address spaces must not overlap. Therefore, if an LROS is designed to accept 
an AROS, the LROS's designers must trade off maximum LROS size against desired 
sizes for their AROS. Typically the LROS will be a maximum of 24K and AROS 


will be a maximum of 32K bytes. 


If you plan on submitting a BASIC Program 
for possible use by TIMEX in an AROS, it 
must not utilize user-defined functions. 
They are not supported in AROS's. 
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1.7.1 LROS 


LROS will typically map into the address space between the $999 and 5FFF 
(24K). If the second display file is to be used instead of the first, then 
the LROS may extend to 7FFF (32K). If the system initialization routine 
detects the presence of an LROS, a jump to the starting address (contained in 
9002H) is performed, thereby passing control to the LROS. The following 
Overhead bytes must appear in every LROS (all addresses are in hex): 


0202 - Not used (one byte) 


9991 - Cartridge Type (one byte) 
1 = LROS 


9002 - Starting address (two bytes) 
Address to be jumped to after operating system 
initialization is complete. 


9904 - Chunk specification (one byte) 

Bits @ = 7 represent Chunks @ - 7 respectively as follows: 
§ = if not in use 

1 = if in use 


1.7.2 AROS 


AROS will typically map into the address space between 899% and FFFF (32K). 

If the second display file is to be used by the system, then the AROS will map 
into the address space between 8999 and DFFF (24K). If the initialization 
routine detects the presence of an LROS, control. is passed to the LROS upon 
completion of the initialization as described above. The LROS is then 
responsible for RUNning any installed AROS. If just an AROS is present, it is 
treated as a BASIC/machine language program with system RAM used for program 
variables. The following overhead bytes must appear in every AROS (all 
addresses are in hex): 


8999 - Language type (one byte) 
1 = BASIC and machine language 
Machine language only 
LOGO 
PASCAL 


2 
3 


nou nou 


8201 - Cartridge type (one byte) 


= AROS 


tarting address (two bytes) - for language type: 
= Beginning of BASIC program 
= Starting address of machine language program 
= To be determined 


4 
C 
2 
8PP2 - S 
] 
2 
3 
4 = To be determined 
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8994 - Chunk specification (one byte) 
Bits @ - 7 represent Chunks @ - 7 respectively as follows: 
") f not in use 
] If in use 


8995 - Autostart Specification (Language type 1 or 2) (one byte) 
0 = If ROS not to be autostarted 
1 = If ROS is to be autostarted 


8896 - Number bytes for user area (two bytes) 
1.8 DOCK BANK 


The architecture of the DOCK Bank is illustrated by Figure 1-4. Either an 
AROS, an LROS, or both may be present in the bank. An AROS alone could 
contain a BASIC and/or machine code program. BASIC code in the AROS would be 
interpreted by the Home ROM, but the entire program would not be loaded into 
the Home RAM. Machine code in an AROS would be executed in the AROS. An AROS 
together with an LROS could be a program in some language (such as LOGO, and 
possibly including some machine code) supported by the LROS. An AROS or LROS 
alone may be up to 56K in size, where size is measured in 8K increments. An 
AROS and an LROS together must not add up to more than 56K and their address 
spaces must not overlap. 


Note the hatched Chunk in Figure 1-4. This indicates a Chunk which is on the 
Same horizontal slice as the machine stack in the Home Bank. This Chunk 
should not be used by the DOCK Bank. 


AROS 


initialization data for AROS 


LROS 





initialization data for LROS 


Figure 1-4. DOCK BANK ARCHITECTURE WITH D FILE 2 OFF 
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1.9 EXPANSION BANKS AND BUS EXPANSION UNIT 


Paragraph 1.9.1 describes Expansion Banks and the Bus Expansion Unit. 


ROM/RAM 
ROM/RAM 
ROM/RAM 


ROM/RAM 


| nowean 
LLLLLLLE. 
| rowsea _| 


ROM/RAM 








ROM/RAM 






Figure 1-5. EXPANSION BANK ARCHITECTURE WITH DF ILE “2 OFF 


1.9.1 Peripheral Expansion Bus 


The Expansion Bus connector allows the attachment of one or more peripherals 
to the T/S 2000. Up to two peripherals may be attached directly to the 
Expansion Bus connector. If more than two peripherals are desired, a Bus 
Expansion Unit which contains four connectors is attached first. These 
connectors may be used to attach multiple peripherals. An additional Bus 
Expansion Unit may be attached to the first one, allowing a maximum of seven 
devices to be attached to the T/S 2000. Each of the devices may also contain 
one or more Expansion Banks. An Expansion Bank is a bank of up to 64K of 
RAM/ROM. The hardware and software architecture of the T/S 2000 supports up 
to 253 Expansion Banks. The Bus Expansion Unit is invisible to software. The 
BEU also contains one additional DOCK connector. 
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The Expansion Banks are used for controlling intelligent devices or for memory 
expansion. They may contain ROM and/or RAM as shown in the memory maps (refer 
to Figures 1-1, 1-2 and 1-5). Except for RAM banks, each Expansion. Bank must 
contain the following overhead information to be properly recognized by the 
system software: 


$200 - Device Specification (1 byte) (Refer to Table 1-3 for a list of 
device specifications. ) 
9091 - Address of device OPEN routine (2 bytes) 
$093 - Address of device CLOSE routine (2 bytes) 
£25 - Address of device SELECT routine (2 bytes) 
$997 - Address of device INPUT routine (2 bytes) 
$009.- Address of device OUTPUT routine (2 bytes) 
$GGB - Address of disk command handler routine (2 bytes) 
(see Device Type (bit 1) below) - 
$9GD - Address of device. Interrupt Handler routine 92 bytes) 
PPPF - Address of device Initialization routine (2 bytes) 
(cold start) 
$011 - Address of device RESET routine (2 bytes) 
(warm start) 
$913 - Device type (1 byte) 
Bit @ = % Bootable 
1 Initializable 
Bit 1 = @ Non-storage device 
1 Storage device (capable of handling disk commands) 
$914 - Device Boot Priority (1 byte) 
(@ - 255) 
$015 - Device interrupt priority (1 byte) 
(@ - 255) 


Table 1-3 
DEVICE SPECIFICATIONS 


Telecommunications Device 
Stringy Floppy 

Floppy Disk 

Hard Disk 

RS232 Interface 
Centronics Interface 


Printer (80-column) 
Local Area Network 
Ram Insertion 
Printer 

’ Keyboard 
Screen 
Reserved 
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SECTION II 
SYSTEM BLOCK DIAGRAM 


2.1 INTRODUCTION 


The T/S 2000 is illustrated in block form by Figure 2-1. The components are 
as follows: 


SCLD -- Standard Cell Logic Design 
Z80 -- Microprocessor 
16K RAM -- 16K Home RAM 
32K RAM -- Optional 32K Home RAM 
16K ROM -- System Software 
8K ROM -- System Software 
MUX -- Multiplexer 
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TS2000 


Figure 2-1. SYSTEM BLOCK DIAGRAM 
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SECTION III 


INPUT/OUTPUT FACILITIES 


3.1 INTRODUCTION 


The T/S 2000 supports many input/output facilities. 
3.2 1/0 PORT LAYOUT MAP 


Ports are configured as illustrated in Figure 3-1 and mapped below. 


FFH: 


DG: 
D1: 
D2: 
D3, D4, D5: 
D6: 
D7: 


FEH: 


Dea ale 


Figure 3-1. BYTE LAYOUT 


Read/Write 


1 Enables D/FILE/2 (secondary display file) 

1 Enables ultra-high-resolution color (expanded attributes) 
1 Enables 64-column display (requires D1 to be set) 

Paper color for 64-column display 

1 Disables the keyboard interrupt (refer to paragraph 5-4) 
1 Enables Extension ROM in the EXROM Bank 


Read 


DG, DI, D2, D3, D4: State of the five keyboard outputs (refer to the 


D5: 
D6: 
D7: 


FEH: 


DM, D1, D2: 
D3: 
D4: 
D5, D6, D7: 


SPECTRUM users! manual Chapter 23) 
Not used 

Tape input 

Not used 


Write 
Border color 
Tape output 


Sound toggle (BEEP) 
Not used 
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FDH: 
FCh: 
FBh: 
FAh: 
F9Oh: 
F8h: 
F7h: 
F6h: 
F5h: 
F4h: 


EFh: 


wa itl 


Bank selection ADDR port 

Bank selection DATA port 

Printer read/write 

Printer read/write 

Printer read/write 

Printer read/write 

Reserved 

Sound chip register data read/write 
Sound chip register address read/write 
DOCK horizontal select read/write 


Reserved 


TIMEX modem uses DF, D7, CF, C7 


TIMEX reserves ports 78h - FFH 


Ports $h - 77h are available* 
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* It is requested that vendors contact TIMEX for port assignment to prevent 


conflicts with other vendors. 


TIMEX Computer Corporation 
1579 Straits Turnpike 
Middlebury, CT. 06720 


Please direct inquiries to: 
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Nineteen ports are illustrated by Figure 3-2 


Display Modes, Extension ROM, Interrupt Control 
Keyboard, Border Color, Tape, Sound 
Bank Controller - Address 

Bank Controller - Data 

Printer 

Printer 

Printer 

Printer 

Note B 

Sound Chip - Data 

Sound Chip - Address 

DOCK Horizontal Select 

Printer 

Printer 

Printer 

Printer 

Note B 





Figure 3-2. T/S 2000 I/0 PORTS 


A) TIMEX reserves I/0 addresses 78 - FFhex; outside world 
will use Q@@ - 77hex. 

B) Reserved 

C) Modem will be DF, D7, CF, C7 

D) Spectraside uses 78h -— 7FH 
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3.3 DUMB DEVICES 
A number of dumb devices are incorporated within the system. 
3.3.1 Keyboard 


The keyboard is a 5 x 8 matrix. The eight-inputs are address lines A8 to Al5 
which are sequentially lowered and an I/0 read is performed to. 1/0 address FEH 
as each address line is lowered. This uses the same routine as the BASIC IN 
command. Bits § to 4 of I/0 port FEH contain the state of the five keyboard 
outputs (refer to Chapter 23 of the SPECTRUM BASIC manual). Refer to 
paragraph 5.2.2 for a description of the differences between the SPECTRUM and 
the T/S 2000's keyboard. 


3.3.2 Tape 
An I/0 read to FEH pulls in the cassette input on bit 6. 


An 1/0 write to FEH bit 3 controls the tape output. There is no provision for 
controlling the tape recorder's motor. 


3.3.3 Sound 


Simple Sound: (BEEP) Sound is generated under software control by toggling 
bit 4 of 1/0 address FEH. 


Full Sound: The sound chip registers are set by writing the register number 
to I/0 address F5h and the value for that register to I/0 
address F6h. . 


3.3.4 Video 


Display file selection is accomplished by writing to bit % of I/0 address 
FFH. A @ enables D/FILE/1, a 1 enables D/FILE/2. D/FILE/1 is the default. 


Ultra-high Resolution color is enabled by writing a 1 to I/0 address FFH. 


64-column display is enabled by writing a 6 to 1/0 address FFH. Paper color 
for this mode is specified by writing the appropriate value into bits 3 
through 5 of I/0 address FFH. A contrasting color ink will be chosen by the 
hardware; for example: 


LD A,#9G1G11G 3; select 64-character 
OUT (FF),A ; mode w/red paper 


Refer to paragraph 6.4 for full details. 


3.3.5 Printer 


The printer is accessed by an I/O request to any I/O address with A7 high, and 
A2 low. 
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3.3.6 Joysticks 


‘The joystick port is selected by writing a 14 to 1/0 address F5h. The 


joystick is then read by reading I/0 address F6h with the player number (1 or 
2) on the upper half of the address bus., i.e., 


ld a, 14 

Out a, (@F5H) 
ld a, PLAYER 
in a, (@F6H) 


The joysticks used are industry-standard. They connect to a 9-pin “D-type" 
connector. 


The byte read is interpreted as follows: 


1 DQ: indicates stick up 

2 Di: pce § indicates stick down 
4 D2: @ indicates stick left 
8 03; Q@ indicates stick right 


16-64 (D4, D5, D6): Not used (all ones) 
128 D7: @ indicates pushbutton depressed 


3.3.7 Sound Chip 


The basic registers in the PSG (Programmable Sound Generator -- G1 8912) which 
Produce the programmed sounds include: 


Tone Generators: Produce the basic square wave tone frequencies for each 
Channel (A, B, C). 


Noise Generator: Produces a frequency modulated pseudo random pulse width 
square wave output. 


Mixers: Combine the outputs of the Tone Generators and the Noise 
Generator. One for each channel (A, B, C). 


Amplitude Control: Provides the D/A Converters with either a fixed or 
variable amplitude pattern. The fixed amplitude is 
under direct CPU control; the variable amplitude is 
accomplished by using the output of the Envelope 
Generator. 


Envelope Generator: Produces an envelope pattern which can be used to 
amplitude modulate the output of each Mixer. 


D/A Converters: The three D/A Converters each produce up to a 16-level 
output signal as determined by the Amplitude Control. 
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All register numbers are in octal. 


An additional register is shown in the PSG Block Diagram (Figure 3-3) which 
has nothing directly to do with the production of sound -- this is the 1/0 
Port (A). Data to/from the CPU may be read/written to/from the 8-bit 1/0 Port 
without affecting any other function of the PSG. The T/S 2000 uses the 1/0 
port to access the joystick. 
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Figure 3-3. PSG REGISTER ARRAY 


3.3.7.1 Tone Generator Control (Registers RO, R1, R2, R3, R4, R5). - The 
frequency of each square wave generated by the three Tone Generators (one each 
for Channels A, B, and C) is obtained in the PSG by first counting down the 
input clock by 16, then by further counting down the result by the programmed 
12-bit Tone Period value. Each 12-bit value is obtained in the PSG by 
combining the contents of the relative Coarse and Fine Tune registers, as 
illustrated by Figure 3-4. 


Coarse Tune Fine Tune 
Register Channel Register 
R1 A RO 
R3 B R2 
R5 Cc R4 
[876] 85] 24] e3/ 82] 51/60] [97 |86) es ]e4]59[82] 6x]e0] 
NOT 


USED 





Figure 3-4. 12-BIT TONE PERIOD (TP) TO TONE GENERATOR 
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Note that the 12-bit value programmed in the combined Coarse and Fine Tune 
registers is a period value -- the higher the value in the registers, the 
lower the resultant tone frequency. 


Note also that due to the design technique used in the Tone Period countdown, 
the lowest period value is $G99G9G99B91 (divide by 1) and the 


highest period value is 111111111111 (divide by 4,995). 


The equations describing the relationship between the desired output tone 
frequency and the input clock frequency and Tone Period value are: 


(a) fT = fCLOCK (b) TPyi9 = 256CTqg + FT19 
16TP 19 
Where: ft = Desired tone frequency 
FCLOCK = Input clock frequency 
TPjg = Decimal equivalent of the Tone Period bits 
TP11 -- TPG 
CT19 = Decimal equivalent of the Coarse Tune 
register bits B3--Bg (TP11--TP8) 
FT19 = Decimal equivalent of the Fine Tune 


register bits B7--B@ (TP7--TP@) 


From the above equations it can be seen that the tone frequency can range from 
a low of fCLOCK (wherein: TPyq = 4,095,9) to a high of fCLOCK (wherein: 

65,520 16 
TP}9=1). Using a 2-MHz input clock, for example, would produce a range of 
tone frequencies from 30.5-Hz to 125-kHz. The T/S 2000 uses a 1.75-MHZ input 


clock. 14.112 Mhz = L764 MHz 


To calculate the values for the contents of the Tone Period Coarse and Fine 
Tune registers, given the input clock and the desired output tone frequencies, 
we simply rearrange the above equations, yielding: 


(a) TPy9 = fCLOCK (b) CT19 + FTqg = TPi9 
l6¢7 256 256 
Example 1: fy = 1kHz 
forocx = 2MHz 
2x10° 
16(1x10°) 
Substituting this result into equation (b): 
FT1o _ 125 
256 =. 256 


-.CT19 =0 = 0000 (B3--B0) 
FTio = 12519 = 01111101 (B7—-BO) 


TPio = = 125 





CTio + 


Example 2: fr = 100Hz 


forock = 2MHz 
2x10° 
= CO 1 
Mee Sean 
Substituting this result into equation (b): 
FT:1o _ 1250 _ 226 
Clie t Fe5 “ose ~*~ 1 S66 


“.CTio = 410 = 0100 (B3-B0) 
FTio = 22610 = 11100010 (B7—80) 
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3.3.7.2 Noise Generator Control (Register R6). -- The frequency of the noise 


source is obtained in the PSG by first counting down the input clock by 16, 
then by further counting down the result by the programmed 5-bit Noise Period 
value. This 5-bit value consists of the lower 5 bits (B4--BG) of register 
R6, as illustrated by Figure 3-5. 


Noise Period 
Register R6 


Perle [es [elele[a [a 
emeernmeeen epenemeeeentetie en 


NOT , 5-bit Noise Period (NP) 
USED to Noise Generator 


Figure 3-5. NOISE PERIOD REGISTER R6 


Note that the 5-bit value in Rll is a period value -- the higher the value in 
the register, the lower the resultant noise frequency. Note also that, as 
with the Tone Period, the lowest period value is @@GM1 (divide by 1); the 
highest period value is 11111 (divide by 31}0). 


The noise frequency equation is: 





fN = fCLOCK 
16 NPig 
Where: fy = Desired noise frequency 
FCLOCK = Input clock frequency 
NPjq = Decimal equivalent of the Noise 


Period register bits B4--B@. 


From the above equation it can be seen that the noise frequency can range from 
a low of fCLOCK (wherein: NPj9=31,Q) to a high of fCLOCK (wherein: 

486 16 
NPyg=1). Using a 2-MHz input clock, for example, would produce a range of 
noise frequencies from 4-kHz to 125-kHz. 


To calculate the value for the contents of the Noise Period register, given 
the input clock and the desired output noise frequencies, we simply rearrange 
the above equation, yielding: 


NPjg = fCLOCK 
16fy 
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3.3.7.3 Mixer Control 1/0 enable (Register R/). -- Register 7 is a 


multi-function Enable register which controls the three Noise/Tone Mixers and 
the two general purpose 1/0 Ports. 


The Mixers, as previously described, combine the noise and tone frequencies 
for each of the three channels. The determination of combining 


neither/either/both noise and tone frequencies on each channel is made by the 
state of bits 85--B@ of R7. 


The direction (input or output) of the two general purpose 1/0 Ports (I10A and 
10B) is determined by the state of bits B7 and B6 of R7. Note that in the 
T/S 2000 there is no second I/0 Port 10B. 


These functions are illustrated by Figure 3-6 and Tables 3-1 and 3-2 


eae lees Le 
e 


—— 
Function input Enable 


Se Se 
Function: Noise Enabie Tone Enable 


Figure 3-6. MIXER CONTROL-1/0 ENABLE REGISTER R7 









Table 3-1 
1/0 ENABLE 
Noise Enable Truth Table: Tone Enable Truth Table: 












R7 Bits Noise Enabled 
B5 B4 B3 on Channel 


R7 Bits Tone Enabled 
B2 Bl BO on Channel 
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Table 3-2 
I/O PORT TRUTH TABLE 





Disabling noise and tone does not turn off a channel. Turning 
a channel off can only be accomplished by writing all zeroes 
into the corresponding Amplitude Control register, R1@, R11, 
or R12 (refer to paragraph 3.3.7.4). 


3.3.7.4 Amplitude Control (Register R10, R11, R12). -- The amplitudes of 


the signals generated by each of the three D/A Converters (one each for 
Channels A, B, and C) is determined by the contents of the lower 5 bits 
(B4--BZ) of registers R1G, R11, and R12 as illustrated by Figure 3-7. 


Amplitude Control 


Register # , Channel 
R10 A 
R11 B 
R12 Cc 


ar fee eos] =|] 50 


= \ 


~) BEET 


amplitude 4-bit “fixed” 
“Mode” amplitude Level. 


Figure 3-7. D/A CONVERTED SIGNAL GENERATION 
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The amplitude "mode" (bit M) selects either fixed level amplitude (M=@) or 
variable level amplitude (M=1). It follows then that bits L3--L@, defining 
the value of a “fixed" level amplitude, are only active when M=@. When 

fixed level amplitude is selected, it is "fixed" only in the sense that the 
amplitude level is under the direct control of the system processor (via bits 
D3--DG). Varying the amplitude when in this "fixed" amplitude mode requires 
in each instance the direct intervention of the system processor via an 
address latch/write data sequence to modify the D3--D@ data. 


When M=1 (select "variable" level amplitudes), the amplitude of each channel 
is determined by the envelope pattern as defined by the Envelope Generator's 
4-bit output E3 E2 El E@. 


The amplitude "mode" (bit M) can also be thought of as an “envelope enable" 
bit, (i.e., when M=@ the envelope is not used, and when M=1 the envelope is 
enabled). A full description of the Envelope Generator function follows in 
Paragraph 3.3.7.5. 

Figure 3-8 illustrates all combinations of the 5-bit Amplitude Control. 


Amplitude Control 


Register # Channel 

~ R10 A 
R11 B 
R12 Cc 


ar[ as [as| [aa] >[aiJo0 


See eee” ‘ : H 
NOT . 
USED Amplitude 
Control 
M 
0 


L3 L2 L1 LO Output 
0 0 0 0+ +*0 0 0 O } The amplitude is 
k A 7 soos * 0 le fixed at 1 of 16 levels 


as determined by 
L3 L2 L1 LO. 


The amplitude is 
variable at 16 levels 
X xX —3 €2 €1 E0 as determined by the 
ae output of the 
Envelope Generator. 
Ke Dan Care) *The all zeroes code is used to turn a channel 
“off”. 


Figure 3-8. FIVE-BIT AMPLITUDE CONTROL 
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Figure 3-9 graphically illustrates a selection of variable level 
(enve lope-controlled) amplitude where the 16 levels directly reflect the output of 
the Envelope Generator. A fixed level amplitude would correspond to only one of 


the levels shown, with the level directly determined by the decimal equivalent of 
BItS..L 3s sb2 kg. 


GRAPHIC REPRESENTATION OF 14[77 — CHANNEL AT 
13 THE DECIMAL VALUES OF THE 3 MAXIMUM 
2 AMPLITUDE CONTROL OUTPUT AMPLITUDE 





— CHANNEL 


1 1 
00 
EP ep “OFF” 
(te) (fe) 


Figure 3-9. VARIABLE AMPLITUDE CONTROL (M=1) 


3.3.7.5 Envelope Generator Control (Register R13, R14, R15). -- To accomplish the 
generation of fairly complex envelope patterns, two independent methods of control 
are provided in the PSG: first, it is possible to vary the frequency of the 
envelope using registers R13 and R14; and second, the relative shape and cycle 
pattern of the envelope can be varied using register R15. The following paragraphs 


explain the details of the envelope control functions, describing first the 
envelope period control and then the envelope shape/cycle control. 


3.3.7.6 Envelope Period Control (Register R13, R14) -- The frequency of the 
envelope is obtained in the PSG by first counting down the input clock by 256, then 
by further counting down the result by the programmed 16-bit Envelope Period 

value. This 16-bit value is obtained in the PSG by combining the contents of the 
Envelope Coarse and Fine Tune registers, as illustrated by Figure 3-10. 


Envelope Envelope 
Coarse Tune , Fine Tune 
Register R14 Register R13 


[57 ]s6]85]e¢]e0) 2] +0] [57] 25] 5 |e] e3|82| 1]20| 


[eris[epre]eria[eri2|erni]erio] ere [ers [err | ers | ers [ ers | era | ere | eps | ero | 


Figure 3-10. 16-BIT ENVELOPE PERIOD (EP) 
TO ENVELOPE GENERATOR 
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Note that the 16-bit value programmed in the combined Coarse and Fine Tune 


registers is a period value - the higher the value in the registers, the lower 
the resultant envelope frequency. 


Note also, that as with the Tone Period, the lowest period value is 
PGYGGGGPBGGAGBGB1 (divide by 1); the highest period value is 
1171111111111111 (divide by 65, 53519). 





The envelope frequency equations are: 


(a) fe FCLOCK (b) EPjg = 256 CT}9 + FTjg 
256 EPig 


Where: fe = Desired envelope frequency 


fCLOCK = Input clock frequency 
EPjg = Decimal equivalent of the Envelope Period 
bits EP15--EP0O 
CT} = Decimal equivalent of the Coarse Tune 


register bits B7--B@ (EP15--EP8) 
FT19 = Decimal equivalent of the Fine Tune 
register bits B7--B@ (EP7--EPQ) 


From the above equation it can be seen that the envelope frequency can range 
from a low of fCLOCK (wherein: EP]9=65,53519) to a high of fCLOCK 


’ ry 10 
(wherein: EPjg=1). Using a 2-MHz clock, for example, would produce a range 
of envelope frequencies from 0.12-Hz to 7812.5-Hz. 


To calculate the values for the contents of the Envelope Period Coarse and 
Fine Tune registers, given the input clock and the desired envelope 
frequencies, we rearrange the above equations, yielding: 





_ ferocx FT10 _ EPio 
BEEN sete Shae Ve gee, 266 
Example: fe = 0.5 Hz 

fococx = 2 MHz 
2x10° 
= ——- = 1 
EPio 256(0.5) 5,625 
Substituting this result into equation (b):° 
FT10 15,625 9 
—_ = ——— = GI + — 
Olio 366 256 . 256 


CTio = 6119 = 00111101 (B7--B0) 
FTi0 = 910 = 00001001 (87--80) 
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3.3.7.7 Envelope Shape/Cycle Control (Register R15). -- The Envelope 
Generator further counts down the envelope frequency by 16, producing a 
16-state per cycle envelope pattern as defined by its 4-bit counter output, £3 
E2 E] E9. The particular shape and cycle pattern of any desired envelope is 
accomplished by controlling the count pattern (count up/count down) of the 
4-bit counter and by defining a single-cycle or repeat-cycle pattern. 

This envelope shape/cycle control is contained in the lower 4 bits (B3--BQ) 

of register R15. Each of these 4 bits controls a function in the envelope 
generator, as by Figure 3-11. 





[e7]es[es|e«}es}e2|er]60]  eunction 


——— 
NOT ; Hold 
USED Alternate To 


Envelope 
Attack Generator 


Continue 


Figure 3-11. ENVELOPE SHAPE/CYCLE CONTROL REGISTER (R15) 
The definition of each function is as follows: 


Hold: When set to logic "1", limits the envelope to one cycle, holding 
the last count of the envelope counter (E3--E%=908@ or 1111, 
depending on whether the envelope counter was in a countdown or 
count-up mode, respectively). 


Alternate: When set to logic "1", the envelope counter reverses count 
direction (up-down) after each cycle. 


When both the Hold bit and the Alternate 
bit are ones, the envelope counter is 
reset to its initial count before holding. 


Attack: When set to logic "1", the envelope counter will count up 
(attack) from E3 E2 £1 Eg=GG90 to E3 E2 £1 Ef=1111; when set to 
logic "@", the envelope counter will count down (decay) from 


1111 to G9@¢. 
Continue: When set to logic "1", the cycle pattern will be as defined by 


the Hold bit; when set to logic "@", the envelope generator 
will reset to @20% after one cycle and hold at that count. 
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To further describe the above functions could be accomplished by numerous 
charts of the binary count sequence of E3 E2 El E@ for each combination of 
Hold, Alternate, Attack and Continue. However, since these outputs are used 
(when selected by the Amplitude Control registers) to amplitude modulate the 
output of the Mixers, a better understanding of their effect can be 
accomplished via a graphic representation of their value for each condition 
selected, as illustrated in Figures 3-12 and 3-13. 


A1S BITS 
63 82 81 B89 


A 
c t 

re) ¥ 

N/| AI E 

T/ TI] R 

t 2 N H 

nN] al alo GRAPHIC REPRESENTATION 
uj} cy] Tye OF ENVELOPE GENERATOR 
—€; «) €] o OuTPUT £3 E2 E1 £0, 


REFER TO FIGURE 3-13 
FOR DETAIL 


Or 





€Pp EP IS THE ENVELOPE PERIOO 
(OURATION OF ONE CYCLE) 


Figure 3-12. ENVELOPE SHAPE/CYCLE CONTROL 
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GRAPHIC REPRESENTATION OF 
THE DECIMAL VALUES OF THE = 
13 : ENVELOPE GENERATOR 13 
12 OUTPUT E3 E2 E1-£0 





 Peieerntees Wretera - Seatac Gl Le 
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Figure 3-13. DETAIL OF TWO CYCLES OF Figure 3-12 


3.3.7.8 I/0 Port Data Store (Register R16). -- Register R16 functions as 
intermediate data storage registers between the PSG/CPU data bus (DA@--DA7) 
and the I/0 port (I0A7--I0AQ). This port is available for reading the 
joystick. Using register R16 for the transfer of 1/0 data has no effect at 
all on sound generation. 


To output data from the CPU bus to a peripheral device connected to I/0 Port A 


would require 


|]. Latch 
2. Write 
3. Latch 
4. Write 


To input data 
]. Latch 


2. Write 
3. Latch 


only the following steps: 


address R7 (select Enable register) 

data to PSG (setting B6 to R7 in "1") 

address R16 (select IOA register) 

data to PSG (data to be output on I/O Port A) 


from 1/0 Port A to the CPU bus would require the following: 
address R7 (select Enable register) 


data to PSG (setting B6 in R7 to "9") 
address R16 (select IOA register) 


4. Read data from PSG (data from I/O Port A) 


Note that once loaded with data in the output mode, the data will remain on 
the I/0 port until changed either by loading different data, by applying a 
reset (grounding the Reset pin), or by switching to the input mode. 


Note also that when in the input mode, the contents of register R16 will 
follow the signals applied to the 1/0 port. However, transfer of this data to 
the CPU bus requires a “read" operation as described above. 
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3035/29) DHS 


The horizontal select register for the DOCK Bank is accessed through 1/0 
address F4h. It is read/write. It is called DOCK Horizontal Select. Each 
bit is active high. This means that if bit 3 of DHS is set high, then Chunk 3 
of the DOCK Bank is mapped into the CPU's address space. 


3.4 BANK CONTROLLER 1/0 PORTS 


The expansion Banks on the T/S 2000 each use a controller IC 
(integrated-circuit). This controller uses two I/O ports. They are: 


FCh - Data Port 
FDH - Address Port 


3.5 CHARACTER OUTPUT 


Character output on the T/S 2000 is accomplished by calling a single routine 
in the system ROM which sends the designated character to the current output 
channel. (i.e., TV or printer, etc.). The routine is accessed via the Z80's 
RST 19 instruction. The character to be output, is passed to the routine in 
the Accumulator (A register). This routine uses the following registers: A, 
F, B', C', D', and E's; preserving BCDEHL ; 
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SECTION IV 
CONNECTOR SPECIFICATIONS 


4.1 INTRODUCTION 


In this section, specifications are provided for the DOCK connector, edge 


connector and joystick connectors. 
4.2 DOCK CONNECTOR (ROS, etc.) 


The T/S 2000 DOCK uses a 36-pin connector. 
these pins is listed below in Table 4-1 and Figure 4-1. 


Table 4-1] 
DOCK CONNECTOR SIGNAL ASSIGNMENT 


opened SIGNAL NAME 





DESCRIPTION 
Address Bus Bit 
+ 5V DC. 
Address Bus Bit 
Address Bus Bit 
Data Bus Bit @. 
Data Bus Bit 7. 
Data Bus Bit 1. 
Address Bus Bit 
Data Bus Bit 2. 
Address Bus Bit 

. Data Bus Bit 6. 
Address Bus Bit 
Data Bus Bit 5. 
Address Bus Bit 
Data Bus Bit 3. 
Address Bus Bit 
Data Bus Bit 4. 
















































The layout and 





Memory Request (active low). 
1/0 Request (active low). 
Refresh Address Bit 7. Buffered. 
Read (active low). Buffered. 

CPU Ml State (active low). 

Write (active low). Buffered. 


function of each of 





14. Buffered. 


12. 
13. Buffered. 


Qa 
° 


is 


Buffered. 
Buffered. 


Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Refresh 



















Bus 
Bus 
Bus 
Bus 
Bus 
Bus 
Bus 
Bus 


Bit 8 
Bit 7. 
Bit 9. 
Bit: 6. 
Bit 10. 
Bit. 5. 
Bit 11. 
Bit 4. 


(active low). Buffered. 


Bank Enable (active low). 





Extension ROM Enable (active low). 

ROS (ROM Oriented Software) ship Select 
(active low). 

ound 
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Figure 4-1. DOCK CONNECTOR 


4.3 EDGE CONNECTOR SPECIFICATION 


The T/S 2000 uses a 64-pin edge connector. 


The layout and function of each of 


these pins are specified in Table 4-2 and Figure 4-2. 


Table 4-2 
EDGE CONNECTOR SIGNAL ASSIGNMENT 













Tape OUT/SPKR 
EAR <— 
DZOUT 
DZIN 
A7RB 
+15V 
D7 
+5V 
Not used 
Not used 
Slot 


SIGNAL NAME 


DESCRIPTION 


Tape/Speaker Output 

EAR Input 

Daisy out. 

Daisy in. 

Refresh Address Bit 7. Buffered. 
+15V DC. 

Data Bus Bit 7. 

Plus 5 Volts. 





































Data Bus Bit @. 
Signal Ground. 
Data Bus Bit 1. 
Signal Ground. 
Data Bus Bit 2. 
CPU Clock (inverted). 
Data Bus Bit 6. 
Address Bus Bit @. 
Data Bus Bit 5. 
Address Bus Bit 1. 
Data Bus Bit 3. 
Address Bus Bit 2. 
Data Bus Bit 4. 
Address Bus Bit 3. 


Interrupt request (active low). 
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Table 4-2 (CON'T) 


SIGNAL NAME DESCRIPTION 


Address Bus Bit 15. Buffered. 

Non Maskable Interrupt (active low). 
Address Bus Bit 14. Buffered. 

CPU HALT Indicator Signal (active low). 
Address Bus Bit 13. Buffered. 

Memory Request (active low). Buffered. 
Address Bus Bit 12. 

I/O Request (active low). Buffered. 
Address Bus Bit 11. 

Read (active low). Buffered. 

Address Bus Bit 1@. 

Write (active low). Buffered. 
Address Bus Bit 9. 

Bus Acknowledge (active low). 
Address Bus Bit 8. 

CPU Wait (active low). 

Address Bus Bit 7. 

Bus Request (active low). 

Address Bus Bit 6. 

CPU Reset (active low). 

Address Bus Bit 5. 

CPU M1 State (active low). 

Address Bus Bit 4. 

Refresh (active low). 

Not used. 

Extension ROM Enable (active low). 
Color Signal - Red. <«<—~ 

ROS (ROM Oriented Software) ship select. 
Color Signal - Green. «= 

Bank Enable (active low). | 

Color Signal - Blue. TTL poSiive 
Ground. 

Ground. 

Analog Sound Signal Output (@-5 V). 
Composite Video Signal Output. iV 


PINS # 











































All A pins are on component side signal of board 
All B pins are on soldering side signal of board 
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Figure 4-2. EDGE CONNECTOR 


4.4 JOYSTICK CONNECTORS 


The T/S 2000 has the built-in capability to use two eight-position joysticks. 
These joysticks are industry-standard. The connectors are industry-standard 
9-pin "D" type connectors. The layout of the connector, and the function of 
. each pin is given below in Table 4-3 and Figure 4-3. 


Table 4-3 
JOYSTICK CONNECTOR SIGNAL ASSIGNMENT 


Direction One eo a 
DOWN Direction Two (active low 
Ler Direction Three (active low). 
21 GHT Direction Four (active low). 
Not used. 
Button Input (active low). 
Not used. 
Read strobe. achve Jaw _no pu 
Not used. 


1 
2 
3 
4 
5 
6 
ri 
8 
9 





soyshick cable | +)mey 


SOO: © ee 


Figure 4-3. JOYSTICK CONNECTOR 
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SECTION V 
CHARACTER SET AND KEYBOARD 
5.1 INTRODUCTION 


For the T/S 2000, this section provides a description of the keyboard and 
details the character set. 


5.2 DESCRIPTION OF KEYBOARD 


The T/S 2000 keyboard is not the same as the SPECTRUM keyboard, and has the 
following features: 


. Hard key typewriter style keyboard with 42-keys, including two shift 
keys, and a SPACE bar 


Full upper and lower-case characters (with descenders) 


. 16-standard predefined graphics keys and 21l-user definable graphics 
keys 


Auto repeat on all keys 
. Audible keyclick (tone) provided for each key 
. Single key entry of BASIC command keywords and tokens 


The T/S 2000's entire character set may be redefined by altering the system 
variable CHARS. This variable points to 256-bytes before the beginning of the 
bit map describing the characters in the character set. The user may thus 
create alternate character fonts, or foreign language characters sets. 


5.2.1 Tokens 


The T/S 2000 uses a system of tokens to increase effective memory 
utilization. Instead of storing, for example, the keyword PRINT as a string 
of 5-characters, the T/S 2000 represents PRINT with a single byte. The T/S 
2000 has reserved characters 165-255 to represent the tokens used in the 
computer. 


When you output, for example, CHR$ 166, the computer's output routine expands 
the token, and actually sends six (6) characters (I, N, K, E, Y, and $) to the 
current output device. This technique creates a two-fold benefit: firstly, 
typing time is reduced, and secondly, memory space is conserved. 
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5.2.2 Spectrum vs T/S 2000 Keyboard 
The following list describes changes to the Spectrum keyboard: 
1) In CAPS LOCK mode SPACE depressed = SPACE 


Both CAPS SHIFT and SPACE depressed = BREAK 


> 


) 
) 
3) Copyright symbol = RESET 
) Vertical bar = STICK 

) 


on 


Left curly bracket = ON ERR 
6) Right curly bracket = SOUND 
7) Tilde = FREE 
8) DELETE is context dependent. In K-mode, the keyword DELETE is assumed 
for the command described in paragraph 6.10. Otherwise the DELETE key 
functions in the usual manner deleting the last character typed. 
5.3 T/S 2000 CHARACTER SET 
The T/S 2000 uses ASCII. With a few.minor exceptions, the T/S 2000's 
character set is fully compatible with ASCII. Table 5-1 is a listing of the 
T/S 2000 character set. 


Table 5-1 . 
T/S 2000 CHARACTER SET 


_ CHARACTER Z80_ ASSEMBLER -AFTER cB -AFTER ED 








































Not used nop 
‘ Not used Id be, NN 
2 Not used ld ‘(bc), a 
3 Not used inc bec 
4 Not used inc b 
5 Not used dec b 
6 PRINT Comma Id b, N 
7 EDIT rica 
8 Cursor Left ex af, af' 
9 Cursor Right add hl, be 
10 Cursor Down ld a, (bc) 
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| 
12 
13 
14 
15 
16 
17 
18 
19 
20 
2] 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4] 
42 
43 
44 
45 
46 
47 
48 
49 
50 
5] 
52 
53 
54 
55 








HA 


Cursor Up 
DELETE 
ENTER 


Number (slug) 


Not used 
INK Control 


PAPER Control 
FLASH Control 
BRIGHT Control 
INVERSE Control 


OVER Control 
AT Control 
TAB Control 
Not used 
Not used 
Not used 
Not used 
Not used 
Not used 
Not used 
Not used 
Space 


Pe + HW - BO BR 49 TH 


NOOPWMH—O™* 
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Table 5-1 (CON'T) 


gB 
gc 
gD 
BE 
OF 
19 
1] 
12 
13 
14 
15 
16 
17 
18 
12 
1A 
1B 
1c 
1D 
TE 
IF 
29 
21 
22 
23 
24 
25 
26 
27 
28 
29 
2A 
2B 
2c 
2D 
aa 
2F 
39 
3] 
32 
33 
34 
35 
36 
37 


Z80 ASSEMBLER -AFTER CB -AFTER ED 


dec be 

inc c 

dec c 
ldc, N 
rrca 

djnz DIS 
ld de, NN 
ld (de), a 
inc de 

inc d 

dec d 
idd, N 
ria 

jr DIS 

add hl, de 
ld a, (de) 
dec de 

inc e 

dec e 
Ide, N 
rra 

jr nz, DIS 
Id hl, NN 
1d (NN), hl 
inc hl 

inc h 

dec h 

Id h, N 
daa 

Jeezy OES 
add hl, hl 
Id hl, (NN) 
dec hl 

inc 1 

dec | 

tds. W..N 
cpl 

ay ne, 01S 
ld sp, NN 
ld (NN), a 
inc sp 

inc (h1) 
dec (h1) 
Id (hi),..N 
scf 








gree DTAAN TAK DTA|AAN ST 
a 
— 
~~ 





yo TOANTAseHTAAaAnN Ss 
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Table 5-1 (CON'T) 


CODE _| CHARACTER 780 ASSEMBLER | -AFTER CB | -AFTER ED 
56 


X 
38 


































































































ip ee. DIS srl b 
oF 39 add hl, sp srl c 
58 : 3A ld a, (NN) sri d 
59 3 3B srle 
60 < 3C srl h 
61 = 3D srl] 
62 > 3E N srl (hl) 
63 ? 3F srl a 
64 @ 49 ld b, b bit QO, b in b, (c) 
65 A 4] Id b,c bit 0, £ out(c), b 
66 B 42 Id b, d bit: .,. -d sbc hl, be 
67 C 43 Id b, e bit 0, e Id(NN), be 
68 D 44 Id b, h bit 0, h neg 
69 E 45 Tidiscbs. -} bit 0, 1 retn 
70 F 46 byt bit 0,(h1) im 0 
71 G 47 Id b, a bit 0, a Id i, a 
72 Hs 48 1d c,. b bit 1, 6 Imes Le) 
73 I 49 Id ic, ¢ bit ye out(c), ¢ 
74 J 4A ld, 4 bate. ade hl,be 
75 K 4B Idec, e bit, 14.2 ld be, (NN) 
76 L 4c Id-c, fi bit. 4 -A 
he M 4D AK (a ose sp oan Cae | reti 
78 N 4E ld c, (hl) bit 1,(h1) 
79 0 4F Idc, a bit 1, a Id r, a 
80 P 59 Id d, b bit: 2,; 6 in d,.{e) 
81 Q 5] Idd,c bit 2, Cc out(c), d 
82 R be 1a-<d, a bit.2, d sbc hl, de 
83 S 53 ld d, e bit 2, e Id (NN), de 
84 T 54 Id d, h bit 2, h 
85 U 55 id.d, i bite2s. 3 
86 Vv, 56 Idd, (ht) bre -25 CHT S| im 1 
87 W 57 ld d, a bit 2,0 4 id as 7 
88 X 58 Ide, b bit 3, b ine, (<) 
89 Y 59 Ide, c bit. 3; °C out(c), e 
90 Z 5A Ide, d bit 3, d adc hl, de 
9] [ 5B ld e, e bit 3, e ld de, (NN) 
92 / 5C ld e, h bit:-3,. hi 

de, bit 3, 
7 ; ag 1§ e; ln) bit 3, hay) im 2 
95 =, 5F ld e, a bit 3, a Id: a, * 
96 £ 6G Id h, b bit 4, b in hs Ce) 
97 a 61 AG: eo’ bit 4, -¢ out(c), h 
98 b 62 Id h, d bit 4, d sbc hl, hl 
99 c 63 Id h,.e bit 4, e Id (NN), h] 
100 d 64 h, h bit 4, h 
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Table 5-1 (CON'T) 


CODE CHARACTER Z80 ASSEMBLER -AFTER CB -AFTER ED 


bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 
res 





















v 





= 
~~ 
~~ 


iv 
vv wee ew 





rid 
inefts. {¢) 


. 






sbe hl, sp 
ld (NN), sp 


v ww 


DDADDADADOANMNMAMAMNM SSS 
vy 


SS cas Sau ee we ee 
v 
~~ aT oO Be eet ae ano on -—-- 
— 
~ 


a 
pane) 
~~ 


v 


sToan0nvn— HST OAnR NO TAR TMANnN OD 


wv 


N& xf <cecCtunsavos es Hwros ao ho 


7 






{ (ONERR) 
STICK . 

}. (SOUND) 
FREE 

© (RESET) 


wv wv ww 


a 
_! 
~ 








Ome ae ew OO 
as,soaonqovueweeeTaanne 


5-5 


SECTION V: 
CHARACTER SET AND KEYBOARD 


Table 5-1 (CON'T) 


CODE CHARACTER “A 280 ASSEMBLER | -AFTER CB |-AFTER ED 


peo 
_ 
~ 


BBE 
vw 
oem 
= 
— 
~ 


w 


w~es a} G21 BY Bb Be 


_ 
— 
bel 
~~ TO I ee ee QAaandonw--- 
— 
~~ 


wwe asoMaane 
b> 
— 
~~ 


OO REN NIN CPP OO OOOO OOOO ON OO 
trunsQUVO DB SK Dw hd AON Op 
i OOOO Oe ee ee 


SCREENS 
ATTR 
AT 
TAB 
VAL$ 
CODE 
VAL 
LEN 
SIN 
COS 
TAN 


a 
b 
¢ 
d 
e 
h 
] 
( 
a 
b 
c 
d 
e 
h 
] 
( 
a 
b 
E 
d 
e 
h 
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Table 5-1 (CON'T) 


CODE CHARACTER vee Z80 ASSEMBLER -AFTER CB -AFTER ED 


cS 
res 
res 
res 
res 
res 
res 
res 
res 
res 
set 
set 
set 
set 
set 
set 
set 

















a 
Ss 
~~ 
— 
—_ 
~~ 


v7 


VynesTOAN CTA es 
St St oS Oy Gy On 
ve Ve Be re ee ee ee ee | 


call nz, NN 
push bc 


wo 
msaToannwnrneeaTaoanovoAeo- 
a 
pat 
—* 


7 
_— 
~~ 


. 









Meee Hs Hs BH ODDOOOCOONNNNSN 
Ps 


















































set 0, a 
set 1, b 
set 1, Cc 
set 1, d 
en ie set l, e 
call z, NN set 1, h 
call NN set 1, 1 

adc a, N set 1, (h1) 
rst 8 set 1, a 
ret nc set 2, b 
pop de ot ay om 
jp nc, NN set 2, d 
out (N), a set 2, e 
CLOSE# call nc, NN set 2, h 
MERGE push de set 2, 1 
VERIFY sub N set-Z,. ( 
BEEP rst 16 set 2, a 
CIRCLE ret c set 3, b 
INK @XX set 3, ¢c 
PAPER jp c, NN set 3, d 
FLASH in a, (N) set 3, e 
BRIGHT call c, NN set 3, h 
INVERSE prefixes instruc- | 


tions using ix 
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Table 5-1 (CON'T) 


CHARACTER 780 ASSEMBLER -AFTER CB._s|-AFTER ED 
DE ) 
















































































































































OVER sbea,..N set 3, (hl 
QUT DF rst 24 set 3, a 
LPRINT EQ ret po set 4, b 
LLIST El pop hl set 4, Cc 
STOP E2 jp po, NN set 4, d 
READ E3 ex (sp, hl set 4, e 
DATA E4 call po, NN set 4, h 
RESTORE E5 push hl set 4, ] 
NEW E6 and N set 4, (hl) 
BORDER E7 rst: 32 set 4, a 
CONTINUE E8 ret pe set 5, b 
DIM E9 jp (hi) get: 5, ¢ 
REM EA jp pe, NN set 5, d 
FOR EB ex de, hl set 5, e 
GO TO EC call pe, NN set 5, h 
GO SUB ED set 5, 1 
INPUT EE set 5, ( 
LOAD EF set 5, a 
LIST FQ set 6, b 
LET Fl set 6, C 
PAUSE F2 set 6, d 
NEXT F3 set 6, e 
POKE F4 call p,. NN set 6, h 
PRINT F5 push af set 6, 1 
PLOT F6 or N set 6, ( 
RUN F7 rst 48 set 6, a 
SAVE F8 ret m set 7, b 
RANDOMIZE FQ ld sp, hl set 7, C 
FA jp m, NN set 7, d 
FB ej set 7, e 
FC call m, NN set. 75.8 
FD prefixes instruc- : Pe 











tions using iy 
cp N 
rst 56 











set 7, 
set 7, 


-_ 
= 
— 


RETURN ) 


COPY 


FE 
FF 


per] 


5.4 SCANNING THE KEYBOARD 


The T/S 2000's Z80 microprocessor is interrupted every 1/60th of a second to 
scan the keyboard. This feature may be disabled by setting bit 6 in I/O port 
FFH. The routine used to perform this function is called UPD_K, and may be 
accessed via the function dispatcher. It returns with bit 5 of FLAGS set if a 
key is depressed, and both the accumulator and LAST K contain the character 
code for the key depressed. 


Thus the T/S 2000's keyboard may be scanned in one of two ways. First, you 


may simply perform a HALT instruction. Then look at bit 5 of FLAGS, and LAST 
K. Second, you may use the function dispatcher to access UPD-K directly, and 
then look at bit 5 of FLAGS and the accumulator. Remember not to execute a 
HALT instruction if interrupts are disabled either by software (a DI 
instruction) or by hardware as noted above. 
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SECTION VI 
SYSTEM SOFTWARE 


6.1 INTRODUCTION 


This section provides a description of system software, data structures, 
system variables, display modes, interrupts, function dispatcher, 1/0 
channels, initialization, bank switching, commands unique to the T/S 2000 and 
mass storage devices. Appropriate explanations are found in this section. 


6.2 DATA STRUCTURES 


Figure 6-1 illustrates the layout of the data structures which are utilized by 
the system software and Figures 6-2 through 6-9 supplement this diagram. 


H UTILITY 
Primary Primary Printer | System ; N 
t Attributes | Buffer Variables i STACK FUNCTION 
oe re DISPATCHER 
File File (OLD) tw 


sP pe 






























22528 23296 23552 23734 
Resciaa 
BBh 







BANK 
SWITCHING 
CODE 






CHANNEL 
INFORMATION 





VARS ELLINE WORKSP STKBOT STKEND 
26710 (26710) (267i) (26712) (26726) (26726) 


25207 CHANS PROG 
26688 2( 











User 
Defined 
Graphics 


oS dve T/S 2000 HOME RAM UTILIZATION MAP 
RAMTOP °~Y eer zk : 
65367 65535 Numeces in WARewrHESIS ARE THE 
| IWITIAL- VALUES FOR THESE VARIABLES, 


Figure 6-1. DATA STRUCTURE LAYOUT 
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Each line of BASIC program has the form illustrated by Figure 6-2. 


More significant byte 


| Less significant byte 








y ¥ 
See ee ea 
Line number Length of Text ENTER 
text + ENTER 


Figure 6-2. BASIC PROGRAM LINE LAYOUT 


Note that in contrast with all other cases-of two-byte numbers in the system, 
the line number here is stored with its most significant byte first: that is 
to say, in the order that you write them down in. 


A numerical constant in the program is followed by its binary form, using the 
character CHR$ 14 followed by five bytes for the number itself. 


The variables have different formats according to their different natures. 
The letters in the names should be imagined as starting off in lower case. 
This order is illustrated by Figure 6-3. 





Sign bit , 
@11 Exponent byte 4 Mantissa bytes | 
ee 
Letter-69h Value 


Figure 6-3. NUMBER WHOSE NAME IS ONE LETTER ONLY 


Figure 6-4 illustrates a situation when a number whose name is longer than one 
letter is used: 


3 : j E ale met 


ye es 


Letter-60h 2nd character Last character Value 


Figure 6-4. LONGER NAME DATA STRUCTURE 
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An array of numbers is illustrated by Figure 6-5: 


The order of the elements is: 

first, the elements for which the first subscript is ] 
next, the elements for which the first subscript is 2 
next, the elements for which the first Subscript is 3 

and so on for all possible values of the first subscript. 


The elements with a given first subscript are ordered in the same way using 
the second subscript, and so on down to the last. 


As an example, the elements of the 3*6 array b are stored in the order b(1,1) 
BUT 2) bO1, 3) b(1,4) b(1,5) b(1,6). D2 7 Be). ons b(2,6) b(3,1) b( aye) <5. 


b(3,6) 
PEELE >| 


Ey es ee ee a eine 
Letter-6@h Total No. of 1st dim. Last dim. Elements 
length of | dimensions 
elements & 
dimensions 
+1 for no. 


of dimensions 


Figure 6-5. ARRAY DATA STRUCTURE 


Structure of a control variable for a FOR - NEXT loop is illustrated by Figure 
6-6. 


Less significant byte 
| More significant byte 











—~— TD 
Letter-60h Value — Limit Step —_ Looping line Statement 
number 
within line 


FIGURE 6-6. FOR NEXT LOOP DATA STRUCTURE 


String structures are illustrated by Figure 6-7: 


ee |S al 
eee a, 


Letter 60h Number of Text of string (may be empty) 
characters . 





Fiaure f-7. STRING NATA STRIICTIRE 
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Figure 6-8 illustrates the data structure of an array of characters: 


J { 


pa pe a es eee ere 
Letter-60h Total No. of dims. 1st dim. Last dim. Elements 
number 
of elements 
& dims. +1 
for no. of 
dims. 





Figure 6-8. CHARACTER ARRAY DATA STRUCTURE 


The calculator is the part of the BASIC system that deals with arithmetic, and 
the numbers on which it is operating are held mostly on the calculator stack. 


The spare part contains the space so far unused. 


The machine stack is the stack used by the Z80 processor to hold return 
addresses and so on. 


Any number (except @) can be written uniquely as 
+m* 2 
where + is the sign 
m is the mantissa, and lies between 1/2 and 1(it cannot be 1) 
and e is the exponent, a whole number (possibly negative). 


Suppose you write m in the binary scale. Because it is a fraction, it will 
have a binary point (like the decimal point in the scale of ten) and then a 
binary fraction (like a decimal fraction): so in binary, 

a half is written .1 

a quarter is written .91 

three quarters is written eel 

a tenth is written .99G119G11991190110011 .-- and so on. With our number 
m, because it is less than 1, there are no bits before the binary point, and 
because it is at least 1/2, the bit immediately after the binary point is al. 


To store the number in the computer, we use five bytes, as follows: 


1. Write the first eight bits of the mantissa in the second byte (we know 
that the first bit is 1), the second eight bits in the third byte, the third 
eight bits in the fourth byte and the fourth eight bits in the fifth byte, 


2. Replace the first bit in the second byte - which we know is 1 - by the 
sign: @ for plus, | for minus. 


3. Write the exponent + 128 in the first byte. For instance, suppose our 
number is 1/19 


1/19 = 4/5 x 273 
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Thus the mantissa mM is .119811991199110911991198119¢81199 in binary (since 
the 33rd bit is 1, we shall round the 32nd up from 9 to 1), and the exponent 


: 9 -3. Applying our three rules gives the five bytes illustrated in Figure 


—— 





zero written here to show + sign 


0111 1101 0100 1100 | 1100 1100 | 1100 1100 
< 


od 
: a 





-3+128 Mantissa 4/5 except that the first bit should be 1 
for exponent. 


Figure 6-9. ZERO WRITTEN HERE TO SHOW + SIGN 


There is an alternative way of storing whole numbers between -65535 and 
+65535: 


1]. The first byte is g. . 

2. The second byte is Q for a positive number, FFH for a negative one. 

3. The third and fourth bytes are the less and more significant bytes of the 
number (or the number +131072 if it is negative}. 

4. The fifth byte is @. 


6.3 SYSTEM VARIABLES 


Refer to the list of system variables outlined in Table 6-1. 


X The variable should not be poked because the system might crash. 
N Poking the variable will have no lasting effect. 


The number in column 1 is the number of bytes in the variable. For two 
bytes, the first one is the less significant byte - the reverse of what you 
might expect. So to poke a value v to a two-byte variable at address n, use 


POKE n,v - 256*INT (v/256) 
POKE n+1, INT (v/256) 


and to peek its value, use the expression 


PEEK n+256*PEEK (n+1) 
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Table 6-1 


SYSTEM VARIABLES 


































KSTATE 
LAST K 
REPDEL 






REPPER 









DEFADD 






K DATA 







TVDATA 












STRMS 
CHARS 













RASP 
Pi? 
ERR NR 















FLAGS 
TV FLAG 
ERR SP 




















LEST SP 














‘MODE 
NEWPPC 
NSPPC 






PPC 





SUBPPC 





BORDCR 












E PPC 
VARS 
DEST 


MORES WE ONTENTS 


Used in reading the keyboard. 
Stores newly pressed key. 
-Time - in 60this of a second that a key must 
be held down before it repeats. This starts 
off at 35, but you can POKE in other values. 
Delay - in 60this of a second between 
successive repeats of a key held down: 
initially 5. ‘ 
Address of arguments of user-defined function 
if one is being evaluated; otherwise @. 
Stores 2nd byte of color controls entered 
from keyboard. 
Stores bytes of color, AT and TAB controls 
going to television. 
Addresses of channels attached to streams. 
256 less than address of character set (which 
starts with space and carries on to the 
copyright symbol). Normally in ROM, but you 
can set up your own in RAM and make CHARS 
point to it. 
Length of warning buzz. 
Length of keyboard click. 
1 less than the report code. Starts off at 
255 (for -1) so PEEK 23610 gives 255. 
Various flags to control the BASIC system. 
Flags associated with the television. 
Address of item on machine stack to be used 
as error return. 
Address of return address from automatic 
listing. 
Specifies. K, L, C, E-or G cursor. 
Line to be jumped to. 
Statement number in line to be jumped to. 
Poking first NEWPPC and then NSPPC forces a 
jump to a specified statement in a line. 
Line number of statement currently being 
executed. 
Number within line of statement being 
executed. 
Border color * 8; also contains the 
attributes normally used for the lower half 
of the screen. 
Number of current line (with program cursor). 
Address of variables. 
Address of variable in assignment. 


ed ed eed od 
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Table 6-1 (CON'T) 


ADDRESS CONTENTS 


G0] 23631 


68S) 


23633 


23635 
23637 
23639 
23641 
23643 
23645 


23647 
23649 
23651 
23653 
23655 
23656 


23658 
23659 


23660 


23662 
23664 


23665 
23666 


23668 
23670 


23672 
23675 


23677 
23678 
23679 
23680 


23681 
23682 


X PTR 
WORKSP 
STKBOT 
STKEND 
BREG 
MEM 


FLAGS2 
DF SZ 


5 TOP 


OLDPPC © 


OSPCC 


FLAGX 
STRLEN 


T ADDR 
SEED 


FRAMES 
UDG 


COORDS 


P POSN 
PR CC 





Address of channel data. 

Address of information currently being used 
for input and output. 

Address of BASIC program. 

Address of next line in program. 

Address of terminator of last DATA item. 
Address of command being typed in. 

Address of cursor. 

Address of the next character to be 
interpreted: the character after the 
argument of PEEK, or the NEWLINE at the end 
of a POKE statement. 

Address of the character after the [?Jmarker. 
Address of temporary work space. 

Address of bottom of calculator stack. 
Address of start of spare space. 
Calculator's b register. 

Address of area used for calculator's memory. 
(Usually MEMBOT, but not always). 

More flags. 

The number of lines (including one blank 
line) in the lower part of the screen: 

The number of the top program line in 
automatic listings. 

Line number to which CONTINUE jumps. 

Number within line of statement to which 
CONTINUE jumps. 

Various flags. 

Length of string type destination in 
assignment. 

Address of next item in syntax table. 

The seed for RND. This is the variable that 
is set by RANDOMIZE. 

3-byte (least significant first), frame 
counter. Incremented every l6ms. 

Address of Ist user-defined graphic. You can 
change this for instance to save space by 
having fewer user-defined graphics. 
x-coordinate of last point plotted. 
y-coordinate of last point plotted. 
33-column number of printer position. 

Less significant byte of address of next 
position for LPRINT to print at (in printer 
buffer). 

Not used. 

33-column number and 24-line number (in 
lower half) of end of input buffer. 
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NOTES 


— POM PO PO PS 


23684 
23686 
23688 
23689 
23690 
23692 





23693 


23694 


23695 


23696 
23697 
23698 


23728 
23730 
23732 
23734 
23736 
23738 


23739 
23740 
23742 
23743 
23744 
23746 
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Table 6-1 (CON'T) 


ADDRESS CONTENTS 






VIDMOD 






Address in display file of PRINT position. 
Like DF CC for lower part of screen. 
33-column number for PRINT position. 
24-line number for PRINT position. 
Like S POSN for lower part. 

Counts scrolls: it is always 1 more than the 
number of scrolls that will be done before 
stopping with scroll?. If you keep poking 
this with a number bigger than 1 (say 255), 
the screen will scroll on and on without 
asking you. 

Permanent current colors, etc. 
by color statements). 

Used for transparent colors, etc. Any bit 
that is 1 shows that the corresponding 
attribute bit is taken not from ATTR P, but 
from what is already on the screen. 
Temporary current colors, etc. (as set up by 
color items). 

Like MASK P, but temporary. 

More flags. 

Calculator's memory area; used to store 
numbers that cannot conveniently be put on 
the calculator stack. 

Not used. 

Address of last byte of BASIC system area. 
Address of last byte of physical RAM. 

Line number to GOTO on error.” 

Line number in which error occurred. 
Statement number within line in which error 
occurred. 

Error number (Report Code). 

Pointer to the System Configuration Table 
Number of Expansion Banks in System 

Current Channel Bank Number 

Address of location above machine stack. 
Video Mode. Non-zero if the second display 
file is open for use. 










(as set up 
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6.4 DISPLAY MODES 
The T/S 2000 has available to its user, four display modes. 


There are two display files and two attribute files. Their addresses are 
shown below. 


Display File One 4000 - 57FF 
Attribute File One 58@@ - 5AFF 
Display File Two 6029 - 77FF 
Attribute File Two 789@ - 7AFF 


The second set of files (D FILE 2/A FILE_2) are usually overlaid by some of 
the system software's data structures. The function dispatcher has a function 
that is used to switch display modes, and these data structures are moved out 
of the way. Refer to paragraph 6-6. 


The display modes are listed below: 


Display Mode 1 -- Normal (D FILE_1) 
24-rows of 32-characters 
256-pixels horizontal x 192-pixels vertical 
One attribute defines one character position (of 8x8 pixels) 
Primary attributes page (A FILE _1) 


Display Mode 2 -- 64-Column Mode (D_FILE_1 and D FILE 2) 
24-rows of 64-characters 
512-pixels horizontal x 192-vertical 
Only paper color is selectable. High brightness 
sno flashing, and ink color are chosen 
by hardware. 





PAPER yields INK 
black white 
blue yellow 
red cyan 
magenta green 
. green magenta 
cyan red 
yellow blue 
white black 
Display Mode 3 -- Secondary Screen Page (D_ FILE 2) 


24-rows of 32-characters 
256-pixels horizontal by 192-pixels vertical 
Secondary attributes page (A FILE 2) 
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Display Mode 4 -- Ultra High Color Resolution (D_FILE_1 and D FILE 2) 
Like Display Mode 1. Each byte in first display file 
defines a given eight-pixels. Each corresponding byte 
in the second display byte defines the attributes for the 
given pixel data. This means that for every pixel row of 
eight-pixels (within a character position), one attribute 
sa be defined for brightness, flashing, ink and paper 
colors. 


6.5 INTERRUPT HANDLING 


The following information details the processes used for handling interrupts 
on the T/S 2000. 


Non-maskable interrupts are to be handled in the following fashion: 


The occurrence of an NMI causes a return address to be pushed to the RAM 
location pointed to by SP and a restart to location 66H occurs. The interrupt 
handler (in whichever bank is selected) services the interrupt and returns. 
Since the state of the system includes the bank selection status of all the 
banks, all interrupt handlers must save and restore these statuses as part of 
their operation. 


Maskable interrupts are to be handled in the same fashion as NMI's. There are 
interrupt fielders at location 38H in each bank other than the Home Bank, and 
an interrupt handler at location 38H in the Home Bank. 


The interrupt handlers for both NMI's and INT's determine whether the 
interrupting device supplies its own interrupt handling. If this is the case, 
then control is passed to the address and bank specified for the device as 
specified in the System Configuration Table. Maskable and non-maskable 
interrupt handling is available in all banks. 


When an interrupt is received, the system will poll each expansion Bank to see 
which bank caused the interrupt. If the interrupt was caused by an expansion 
Bank, the interrupt handler for that bank will be called. Please note that 
all banks should be queried, as, when an interrupt is received, it may have 
been caused by several banks simultaneously. 
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6.6 FUNCTION DISPATCHER 


Located at location 6200H (or FA5QH if D/FILE/2 is open), is a function 


dispatcher which will, when passed two arguments on the machine stack, perform 
various functions for applications and systems programmers. 


The arguments passed to the function dispatcher are contained in a Single 
word. Bits $-14 contain the service code for the function you are 
requesting, and bit 15 is a jump/call selection flag. If- bit 15 is set, the 
dispatcher will jump to the function you have requested. If bit 15 is reset, 


the dispatcher will call the routine and then return to its (the dispatcher's) 
caller. 


Table 6-2 is a list of functions currently provided by the dispatcher. 


Table 6-2 
T/S 2000 FUNCTIONS 


FUNCTION SERVICE CODE 


W_TAPE 
R_TAPE 
RD BIT 
R EDGE 
SVM 
LOAD 
MERGE 
SAVE 
CHNG VID 
W_BORD 



















Write a block to tape. 
Read a block from tape. 
Read a bit from tape. 
Read an edge from tape. 
General tape routine. 
Load. 

Merge. 

Save. 

Change video mode. 
Write border color. 
Reserved. 

Reserved, 

Reserved. 

Reserved, 





























GET STATUS 
GET NUMBER 
BANK ENABLE 
GOTO_BANK 
CALL_BANK 
XFER_BANK 






Refer to paragraph 6.9. 
















PS ess sha ed ed dS ee 
OWOONAMNHPWNHHOW OND OBRWNH—a 







Reserved. 











2] Reserved. 

22 Reserved. 

23 Reserved. 

24 Reserved. 

25 Scan keyboard. 

26 Sound routine. 

27 BEEP command. 

28 COPY command. ; 

29 Send char. to screen. 
30 Set print position. 






w 
~_ 


Fix attribute byte. 
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Table 6-2 (CON'T) 









Temp. Atts., Perm. Atts. 
Clear lower half of screen. 
Clear entire screen. 
Printer buffer sent to print. 
Send scan to printer. 
Remove slugs from line buffer. 
NEW command. 

Initialize. 

Input character. 

Select current stream. 
Insert bytes. 

Reset calculator stack. 
CLOSE command. 

Close channel. 

OPEN command. 

Open channel. 

CAT command. 

DELETE command. 

FORMAT command. 

MOVE command. 

Flash char. in A to screen. 
Find BASIC line. 

Find sub-line. 

Record length. 

Delete record. 

Send line to output. 

. Check syntax. 

Execute line. 

FOR command. 

STOP command. 

NEXT command. 

READ command. 

DATA command. 

RESTORE bc. 

RAND command. 

CON'T command. 

Jump to line. 

Fix 1 byte # from calc. 
stack. 

Fix 2 byte # from calc. 
stack. 

CLEAR command. 

CLEAR bc. 

GOSUB command. 

Free space left. 

RETURN command. 

PAUSE command. 

Break key pressed? 

DEF command. 

LPRINT command. 

PRINT command. 

Print sequence. 

INPUT command. 





































































RETURN 
PAUSE 
BREAK? 
DEF 
K_LPR 
K_PRIN 
P_SEQ 
INPUT 
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Input sequence. 
Test CURCHL=KB. 
Adjust attributes sysvars. 
Adjust attributes sysvars. 
Screen address calculator. 
























































HIFLSH 
SCRMBL 



















































































































PLOT PLOT command. 

PLOTBC Plot ¢.: pb: 

GET_XY Get x and y. 

CIRCLE CIRCLE command. 

DRAW DRAW command. 

DRAW L Draw line. 

EXPRN. Expression Evaluator. 
F SCRN Run time action for SCREEN $ 
F-ATIR Run time action for ATTR. 
RND RND action. 

F PI PI action. 

F INKY INKEY action. 

FIND_N Find variable. 

PSHSTR Push string. 

PAEDCB Push: ASE, 0,.-G, Be 
LET LET command. 

POPSTR Pop string. 

DIM DIM command. 

STKUSN Stack unsigned number. 
STK A Stack A. 

STK_BC Stack BC, 
ININT - Read/Stack Integer. 
FP2BC Get 16 bit #. 

FP 2A Get 8 bit #. 

QUTPUT Output number on stack. 
SUB Subtract. 

ADD Add. 

MULT Multiple (int). 

TIMES Multiply (F.P.). 
DIVIDE Divide. 

TRUNC Truncate. 

FLOAT Force Int F.P. 

INTDIV Integer Divide. 

INT 

EXP 

LN ‘ 

ANGLE Angle calculator. 

COS COS. 

SIN SIN. 

TAN TAN. 

ATN ATN. 

ASN ASN. 

ACS ACS. 

ROOT SQR calculator. 

TO THE Exponentiation. 

RDCH Read character. 


SENDCH Send character. 
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Table 6-2 (CON'T) 


FUNCTION SERVICE CODE ACTION 


Write character 
Keyboard scan 
Print cursor left 
Print cursor right 
Print newline 
Print message 

CLS command 
Scrolling routine 
Point action. 
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The following paragraph describes some of the more useful functions provided 
by the dispatcher. 


6.6.1 W_TAPE 
Write a block of- data from memory to cassette tape. 


This routine will write the number of bytes specified in the DE register from 
memory to TAPE. The Ix register points to the first byte to save. This byte 


should be preceded by the byte in A which is used to identify the type of 
block: 


Usually @ for data 
- =] for header 


The format of data on tape is a leader at 806.5-Hz, one cycle of 2040-Hz, and 
then data. The data is MS bit first. A zero bit is 1-cycle of 2040-Hz. A 
one bit is I-cycle of 1020 Hz. Lastly comes the parity byte. This is the XOR 
of all data bytes -- formatted as a data byte. All frequencies are nominal. 


This routine aborts with an Report Code D if the BREAK key is pressed. 


6.6.2 R_TAPE 
Read a block of data to memory from cassette tape. 


This routine reads in the number of bytes specified in the DE register from 
tape. The routine should be entered with the A register equal to the block 
type: ; 


9 
-1 


data 
header 


The IX register should point to the memory location into which the first data 
byte should be loaded. 


The routine returns carry set if there were no errors. It returns carry reset 
if the checksums did not match, or the block consisted of fewer than DE bytes 
or the verify failed or the block type was wrong. 


The routine will abort with an Report Code D if the BREAK key is pressed. 


6.6.3 CHNG VID 


\ 
\ 


Change video mode. Se 


This function is used to “open and "close" the second display file (and its 
corresponding attributes file - D.FILE_2 and A FILE.2). If the second display 
file is closed, it should not be used by the applications programmer because 
data structures used by the Operating System currently overlay the needed 


memory area. 
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To access this routine, you merely pass it a value in the accumulator. Valid 
values are shown in Table 6-3. | 


Table 6-3 
CHANGE VIDEO MODE ACCESS CODES 


Normal video mode (D/FILE/1) 

Second display page (D FILE 2) 
Ultra-high-resolution Color mode (D FILE_1 and 
Dif ILE. .2) tener 
64-column mode - paper black. 


64-column mode - paper blue. 
64-column mode - paper red. 
64-column mode - paper magenta. 
64-column mode - paper green. 
64-column mode - paper cyan. 
64-column mode - paper yellow 
64-column mode - paper white. 





A system ‘Ae VIDMOD, keeps track of the current display mode (see Table 
6-3 above). 


Note that using the second display file means that the function dispatcher, 
and system stack will move to the top of memory. This means that you should 
only open the second display file if you are operating a 48K machine. 


6.6.4 BREAK? 

Read the BREAK key. 

This routine looks directly at the keyboard to determine if both CAPS SHIFT 
and SPACE are being depressed (i.e.; BREAK). It returns carry reset if the 
BREAK key is depressed. 

6.6.5 FIND_N 


Parse and find a specified variable. 


This routine will skip CHADD over the identifier (variable name) specified. 
It will adjust bit 6 of FLAGS for the type of the variable as follows: 


Numeric 
String 


Set 
Reset 


SECTION: VE: 
SYSTEM SOFTWARE 


It will return with NC if the system is checking syntax, or if the variable 
was found when FIND_N searched the variables area (VARS) for the specified 
variable. 


It will return with Z if array. (i.e.; '(' present if variable not found or 
checking syntax and array or string if running and variable found). 


If running (i.e., not checking Syntax), Then HL—s : 


Last character of identifier in record if found (NC), 
First character of name in text if not found (C), 


C := First character of name with bits 5 and 6 right, and bit 7 OFF. 

If checking syntax, C gets bits @ - 4 OFF, 5 and 6 correct (as above), and 
bit 7 OFF. 

6.6.6 RDCH 

Wait for a character from current channel. 


This routine waits for a character from the current input stream. It places 
the character in A. 


If the current device is a finite device, and an end of file arrives, then 
RDCH aborts with an Report Code 8. 


6.6.7 INCH 

Get character from current channel without waiting. 

This routine reads a character from the current input stream without waiting. 
It returns C if the character is OK. It returns NC, NZ if end of file (for a 
finite device; i.e.: one like a disk file for which it can always be told if 

there are any more characters to come). 


It will return NC, Z if no character yet (for an infinite device, like the 
keyboard). 


6.6.8. SELECT 
Select the current input stream. 


The routine sets the current channel to be that for stream A. 
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Specified Streams 


STREAM ID NO. CONNECTION 

HID-K -3 Keyboard 

HID-S -2 Screen 

HID-R -] RAM insertion 

COM-ST g Stream for commands 
INP-ST ] Stream for input data 
PR-ST 2 Stream for PRINT 
LPR-ST 3 Stream for LPRINT 


Streans whose ID numbers are less than zero, are referred to as hidden. They 
are tied unalterably to specific channels. 

6.6.9 SCRMBL 

Screen address calculator. 

This routine will set HL pointing at a byte in the primary display file, given 
BC holding PLOT-type coordinates. B should be holding the y-coordinate, and C 
should be holding the x-coordinate. The accumulator will hold the bit number 
in (HL) where the pixel is stored. (Zero for left-hand = MS end, one for 
right-hand = LS end.) 

The routine preserves DE. 

6.6.10 PLOTBC 


Plot a point on the screen. 


This routine performs the equivalent of PLOT c,b. It sets COORDS to the 
coordinates specified. 


There are four options depending on two bits of PFLAG, as listed by Table 
6-4. Bit 9 is XOR-CH. Bit 2 is INV-CH. 


Table 6-4 
PLOTBC OPTIONS 


Set bit. 


Reset bit. 
Invert bit. 
Leave bit. 





This routine adjusts the proper attributes byte for the primary display file. 
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6.7 1/0 CHANNELS 


The T/S 2000 uses a system of I/0 channels (or "“streams") to create a 
structured environment under which input and output in and around the system 
may be performed. 


The following paragraph describes how the T/S 2000 handles these streams. 
(Also see Character Output, paragraph 3.5. 


6.7.1 I/0 Channel Tables 


The T/S 2000 uses a number of tables located in the Home ROM and RAM. These 
tables contain initialization and other data for the “permanent" (dumb) 
devices (keyboard, screen, and printer) and initialization data for I/0 
streams. 


SELTAB is a table containing offsets to the device dependent initialization 
routines for the channels 'K', 'S', and 'P'. The appropriate routine is 
invoked whenever a channel is selected (i.e., when a PRINT # is done). This 
table is illustrated by Figure 6-10. 


i 

SEL—K-$ SEL_K is the keyboard initialization routine 
il : 

SEL—s-s SEL_S is the screen initialization routine 


SEL_P is the printer initialization routine 


Figure 6-10. SELTA® TABLE 





Any other dumb devices must also have entries in this table. 
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A new table (to reside in Home RAM) is needed to contain similar information 
for the intelligent devices. The data for this table is obtained from the 
Expansion Banks during initialization (refer to paragraph 6.8.4).). This 


table is integrated into the SCT (System Configuration Table) and has the 
structure illustrated by Figure 6-11. 






‘device-spec’ 
bank no. 
init addrH 


high order byte of init routine address 
Init addr 


low order byte of init routine address 


Figure 6-11. SELTAB INTELLIGENT DEVICE TABLE 


This table must be searched whenever an intelligent device is selected. 


SPEC_T is a table containing offsets to the stream open routines for the 


channels 'K', 'S', and 'P'. The appropriate routine is invoked whenever a 


strean is opened using OPEN #. This table has the structure illustrated by 
Figure 6-12. 


OPEN K is the keyboard stream open routine 


ug 
open_s-$ 


OPEN S is the screen stream open routine 
*p’ 
open_p-$ OPEN _P is the printer stream open routine 





Figure 6-12. SPEC_T TABLE 


Any other dumb devices must also have entries in this table. 
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A new table (to reside in Home RAM) is needed to contain similar information 
for the intelligent devices. The stream open data for this table is obtained 
from the Expansion Banks during initialization (refer to paragraph 6.8.4). 
This table is integrated into the SCT and has the structure illustrated by 
Figure 6-13. 


"device-spec’ 
bank no. 
open addrH 
open addrL 


high order byte of open routine address 
low order byte of open routine address 





Figure 6-13. SPEC_T INTELLIGENT DEVICE TABLE 


Whenever SPEC_T is searched and a match is not found, the new table must also 
be searched. 


CL_TAB is a table containing offsets to the stream close routines for the 


channels 'K', 'S', and 'P'. The appropriate routine is invoked whenever a 
strean is closed using CLOSE #. This table has the structure illustrated by 
Figure 6-14. 


i" 
CLSE.K-$ CLSE_K is the keyboard stream close routine 
"s” 
CLSE—S-$ CLSE_S is the screen stream close routine 


CLSE—P-$ |. CLSE_P is the printer stream close routine 





Figure 6-14. CL_TAB TABLE 


Any other dumb devices must also have entries in this table. 
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A new table (to reside in Home RAM) is needed to contain similar information 
for the intelligent devices. The stream close data for this table is obtained 
from the Expansion Banks during initialization (refer to paragraph 6.8.4). 
This table is integrated into the SCT and has the structure illustrated by 
Figure 6-15. 


‘device-spec’ 
bank no. 


close addrH 


high order byte of close routine address 
close addrt 


low order byte of close routine address 





Figure 6-15. CL_TAB INTELLIGENT DEVICE TABLE 


This table is searched whenever an intelligent device is closed. 


CHINIT is a table containing I/0 addresses for channels 'K', 'S', 'R', and 
'p'. This table has the structure illustrated by Figure 6-16. 


SENDTV address of the output routine 
IN-K address of the input routine 
"K’ _ device specification 





SENDTV 
ERRJ 
*S’. 


SENDTV 
ERRJ 
*p* 


Figure 6-16. CHINIT TABLE 
Any other dumb devices must also have entries in this table. This information 


is loaded into Home RAM (at location CHANS) during system initialization 
(refer to paragraph 6.8.2). 
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A new table is needed to contain channel information for the intelligent 
devices. The channel data for this table is obtained from the Expansion Banks 
during initialization (refer to paragraph 6.8.4). This table is integrated 
into the SCT and has the structure illustrated by Figure 6-17. 









bank no. 
output addrH 
output addrL 
input addrH 


input addrLl 
"device - spec’ 





high order byte of output routine address 
low order byte of output routine address 
high order byte of input routine address 
low order byte of input routine address 


terminator 


Figure 6-17. CHINIT INTELLIGENT DEVICE TABLE 
6.8 INITIALIZATION PROCEDURES 


For operation of the T/S 2000 to commence, the system, Home Bank, DOCK Bank, 
and the peripheral expansion Banks must be initialized. 


6.8.1 System Initialization 


The System Configuration Table is built upon powerup. This table contains 
information describing the configuration of the TS 2000 system and is used by 


the initialization routines to determine what action to take. Table 6-5 lists 
the Configuration Table. 


Table 6-5 
CONFIGURATION TABLE 



















LAOS 





EXP, BANK 1 EXP, BANK a 



















———_— 
LANGUAGE TYPE | CARTRIOGE TYPE 
CAATAIOGE TYPE START AOOR 
START AOR CHUNK SELECT 
CHUNK SELECT 
AUTOSTART 

@ BYTES OF VAR 
space 


PRESENCE FLAG 
BANK NUMBER 
DEVICE SPEC 
(CHUNK SPEC IF RAM) 
OPEN ROUTINE AOOR 
CLOSE ROUTINE ADOR 
SELECT ROUTINE ADOR 
INPUT ROUTINE AOR 
OUTPUT ROUTINE ADOR e 
DISK CMD HANOLEA AOOR |» o 
INT HANOLER ADOR 





PRESENCE FLAG 
BANK NUMBER 

o | cevice sree 

o | (CHUNK SPEC IF RAM) 

e | OPEN ROUTINE ADOR 
CLOSE ROUTINE ACOR 
SELECT AOUTINE ADOR 
INPUT ROUTINE ADDR 
OUTPUT ROUTINE acon 
DISK CMO HANOLER ADOA 
INT HANOLER ADOR 

eo | INIT ROUTINE ADDR 

o | RESET ROUTINE ADOR 

o | DEVICE TYPE 

DEVICE BOOT PRIORITY 

eo | DEVICE INT PRIORITY 




































































INIT ROUTINE ADOR 
RESET ROUTINE ADOR 
DEVICE TYPE 

DEVICE BOOT PRIORITY 
DEVICE INT PRIORITY 












All fields, except for the presence flag, bank number and Chunk specification 
for RAM banks are read by the initialization routine from the bank in 
question. Note that only intelligent devices, and RAM banks appear in the 
System Configuration Table. Configuration information for dumb, devices is 
stored in the channel I/0 tables described in paragraph 6.7.2. The presence 
flag takes on the following values: @ if nothing present; 1 if intelligent 
device is present; and 2 if RAM is present. 
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6.8.2 Home Bank Initialization 


If there are neither AROS nor LROS attached to the system, the initialization 
of the Home Bank proceeds as it currently does in the Sinclair Spectrum, with 
the following exceptions: 


After loading the permanent device channel information, load the channel 
information for each intelligent. device (if any). ; 


Load the bank selection code and function dispatcher from the Home ROM 
Extension to the Home RAM in Chunk 3. 


Build (in Home RAM) new channel 1/0 table and the stream 1/0 select, open, and 
close tables (as described in paragraph 4.3.2). If there are no intelligent 
devices, then these tables are empty. 


Display, on the screen, the copyright messages. 
6.8.3. ROS Bank Initialization 


The initialization procedure for the ROS Bank is as follows: 
If LROS present Then 
If LROS present Then 
perform basic system initialization and pass control to the LROS 
boot address 


Else 
If AROS present Then 
If AROS language = BASIC Then 
If to be autostarted Then 
Perform basic system initialization and 
Run the AROS 


Else 
Perform basis system initialization 


Else 
If AROS language = Machine code Then 
perform basic. system initialization and pass 
control to the AROS boot address if it is to be 


autostarted. 

Else 
Report Code - AROS contains code for a language 
without the proper LROS 


Else 
No ROS present. 
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6.8.4 Peripheral Expansion Banks Initialization 


The initialization procedure for intelligent devices can be described as 
follows: 


For each Expansion Bank Do: 
If not RAM Then 
eae configuration information into the System Configuration 
able. 
If the initialization type indicates that the device is to be 
initialized, call the initialization routine in the Expansion 
bank. 
Else 
Set the presence flag for RAM 
Set the Chunk spec 
Load interrupt handler into Chunk % at location 38H 
Endif 
Assign a bank number 
Endfor 
Boot the device with the highest book priority. 


6.9 BANK SWITCHING COMMUNICATION ROUTINES 


Communication between banks is accomplished by the transfer of control from 
one bank to another. Two layers of software are provided to programmers for 
this purpose. These layers are: ; 


Indirect Communication 
Direct Communication 


Services provided by these layers are described by giving a high level 
procedural interface and a description of the processing performed. These 
services are available to all banks. Also, advanced 1/0 features provided by 
high level languages are build on these software layers. 


6.9.1 Indirect Communication 


The Indirect Communications layer consists of a set of assembly language 
routines which provide call/return and goto types of transfer of control and a 
routine for the transfer of data. For each of these routines there exists, in 
each bank other than the Home Bank, an interface routine. The interface 
routines mediate between the calling code and the code actually performing the 
service required in a transparent fashion. There is only one copy (in the 
Home ROM) of the actual service code for the Indirect Communications 

routines. These routines have the following syntax and semantics: 


GOTO BANK (addr, bank, hori zontal-select) 


addr - The memory address to which control is to be 
transferred. 

bank - The number of the bank in which the memory address 
resides. 

horizontal-select - A bit pattern describing which Chunks are to 
enabled (@ indicates enable, 1 indicates 
disable). 
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This routine causes an unconditional transfer of control without return. The 


aa bank and the Chunk in which the specified memory address resides are 
selected. 


CALL_BANK (addr, bank, horizontal-select, param-in, param-out) 


addr - the memory address to which control is to be 
transferred. 

bank - the number of the bank in which the memory address 
resides. 


horizontal-select - a bit pattern describing which Chunks are to 
enabled (@ indicates enable, 1 indicates disable). 


param-in number of bytes passed to called routine on the 
stack. 
param-out number of bytes returned on the stack to the 


calling routine. 
This routine causes an unconditional transfer of control with return. The 
specified bank and the Chunk in which the specified memory address resides are 
selected. 


XFER_BYTES (src-addr, src-bank, dest-addr, dest-bank, length, direction) 


src-addr - the memory address from which the data is to be taken. 
scr-bank - the number of the bank from which the data is to be taken. 
dest-addr - the memory address to which the data are to be transferred. 
length - the number of bytes to be transferred. 


direction - -a flag indicating the direction of the transfer: -] for 
high address to low or | for low address to high. 


This routine causes the specified string of bytes to be moved to the specified 
location within the specified bank. The status:‘of both the source and 
destination banks are left unchanged by this operation. 


6.9.2 Direct Communication 


This layer of software provides a lower level of services to the systems 
programmer. The routines provided by this layer allow the selection status of 
any bank or Chunk to be read or modified. This layer provides the following 
routines: 


BANK ENABLE (bank, horizontal-select) 
~ bank - the number of the bank to be selected. 
horizontal-select - a bit pattern describing which Chunks are to 
enabled (@ indicates enable, 1 indicates disable). 


This routine allows the selection status of any bank or Chunk to be modified. 
GET_BANK_STATUS (bank, status-ret, hor-sel-ret) 
bank - the number of the bank whose status is to be read. 
status-ret - where the status information is to be returned. 
hor-sel-ret- where the horizontal select value is to be returned. 


This routine allows the status and horizontal select (which Chunks are 
selected) of any bank to be read from the bank selection hardware. 
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GET _BANK_NUMBER (bank-no-ret, addr) 
bank-no-ret - where the bank number is to be returned. 
addr an address 


This routine returns the number of the bank which currently owns the Chunk in 
which addr resides. 


6.9.3 Restrictions 


The above routines may be used as desired by programmers with the following 
restrictions: 


Any service routine (i.e., CALL_BANK) which manipulates Chunks (selecting 
and/or deselecting) must return the changed Chunk statuses to their original 
values. 


Any code running in a Chunk which “shadows” a RAM Chunk in another bank must 
access data in that RAM Chunk via the indirect data transfer routine XFER 
BYTES (refer to paragraph 6.9.1). 


Any bank wishing to enable a Chunk shadowed by Chunk 3 of the Home Bank should 
do the following: 1) Move the machine stack to the Chunk to be enabled (this 
implies the presence of RAM in this Chunk). If the value of the stack pointer 
is to be modified, its old value should be saved. 2) The bank selection code 
running in Chunk 3 of the Home Bank should be copied into the shadowed Chunk, 
at the same address at which it resides in the Home Bank. Otherwise, no bank 
will be able to access the bank selection software. 3) The stack must be 
restored to its original state when the shadowed Chunk is disabled and Chunk 3 
in the Home Bank must be re-enabled. (If the second display file is in use, 
then the above applies to Chunk Fe} 


You must never turn on two Chunks on the same horizontal level. The bank 
switching routines will always avoid this situation because when you request a 
given Chunk to be turned on, the bank switching routines will turn off that 
Chunk in any other bank in which it is selected. 


6.10 COMMANDS IMPLEMENTED ON THE TIMEX SINCLAIR 2000, BUT NOT ON THE ZX 
SPECTRUM. 


The following commands and functions are additions to those which are already 
provided on the Spectrum. 


6.10.1 SOUND reg, value; reg, value; etc. 


This command allows the programmer to manipulate the 15-registers of the 
General Instrument Ay-3-8912 Programmable Sound Generator. The semantics of 
the values assigned to the registers are described in the General Instrument 
Programmable Sound Generator Data Manual, and in paragraph 3.3.7. 


The valid values for reg are 1-15, and are specified in decimal. The valid 


values for value are 9-255. If any of the values is found to be out of 
range the Report Code B Integer Out of Range, is given. 
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6.10.2 STICK (device type, player) 


This function allows the programmer to read the status of devices attached to 
the joystick port where: 


device type =.1 for joystick 
2 for pushbutton 

player = lor 2 
Value returned for joystick =@ - joystick on center 
1 - joystick up 
2 - joystick down 
4 - joystick left 
8 - joystick right 
Values returned for pushbutton § - pushbutton not depressed 
1 = pushbutton depressed 


If the specified values are not within the ranges given above the Report Code 
A (Invalid Argument) is displayed. 





Combinations are allowed (e.g., joystick diagonally up 
and to the left yields a value of 1 + 4 = 5) 


DELETE m,n 
DELETE ,n 
DELETE Mm, 


This command allows the programmer to delete a sequence of lines from a 
program. The 'm, n' specification causes the sequence of lines fromm ton 
inclusive to be deleted from the program. The ',n' specification causes the 
lines from the beginning of the program to n inclusive to be deleted. The 
'm,' specification causes the lines from m to the end of the program inclusive 
to be deleted. It should be noted that this causes the DELETE key to become 
context dependent as described in paragraph 6.9. 


If the range n,m does not include at least one line in the BASIC program or n 
is greater then m, the Report Code A (Invalid Argument) is displayed. 


6.1073 FREE 


This function returns the number of bytes of free space currently available in 
the Home RAM for either program or variables. 
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This command causes the device associated with the specified stream to be 
reinitialized by performing a call to its initialization (warm start) address 
(refer to paragraph 6.8.1). If a channel number is not provided, the system 
initializes any new devices it finds (as it normally does during powerup). 


If the stream number is specified and it has not been previously opened using 
the OPEN command (refer to paragraph 6.10), the Report Code 0 (Invalid Stream) 
is given. The RESET * command does the equivalent of turning the machine off, 
and then on again. 


ON ERR GOTO linenumber 
ON ERR CON'T 
ON ERR RESET 


These statements allow the programmer to disable automatic program termination 
upon encountering an error condition. The ON ERR GOTO linenumber allows the 
programmer to cause the transfer to the specified linenumber to handle the 
encountered error. The error number and linenumber on which it occurred are 
available by PEEKing the locations (23739) and (23736). The statement number 
within the line that caused the error is stored in location (23738). The ON 
ERR CON'T statement causes the program to resume execution at the statement in 
which the error originally occurred. If an ON ERR CON'T statement is 
encountered and an error has not occurred, then the command is ignored. The 
ON ERR RESET command disables this feature causing the program to report 
errors and terminate in the usual manner. 


6.10.5 Stringy Floppy/Floppy Disk Commands 


The following commands are used for accessing disk and disk-like storage 
devices which are present on an Expansion Bank. A one-bit specifier is 
present in the Expansion Bank memory space which determines whether or not the 
device attached to that bank can handle disk-like commands (CAT, FORMAT, SAVE, 
LOAD, ERASE, MOVE, VERIFY, MERGE). All Expansion Banks, except for RAM banks, 
are expected to be able to handle the OPEN, CLOSE, PRINT # and INPUT # 
commands. 


If one of the disk-like commands is attempted to a non-disk-like device, the 
Report Code J (Invalid 1/0 Device) is displayed. Execution of these commands 
is handled by the Expansion Bank itself. The Home ROM is responsible for 
parsing the command and calling the appropriate routine in the specified 
Expansion Bank. The Expansion Bank handles those operations which are device 
dependent (special syntax, extra parameters, etc.). 


6.10.6 OPEN #c, "m", “filespec" (,. “file type spec") 


Opens a stream identified by c and creates a new file or opens an existing 
file as specified by "filespec". A filespec is formed by the concatenation of 
a “volume spec" and a "£4; ]ename". The “volume spec" specifies the device to 
be used and is optional. If it is not specified, a default device is 
selected. "File type spec" is device dependent and may be used to specify 
such things as random or sequential access, record length, etc. 
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6.10.7 CLOSE ic 


Closes the file associated with the specified stream after flushing the 
appropriate buffers where necessary. 


6.10.8: CAT “m", “volspec" 


Causes a list of files on the specified volume to be displayed on the screen. 


6.10.9 FORMAT "m", "“volspec" 


Formats the media on the specified volume and gives it the specified volume 


name. 


6.10.10 SAVE * (Note '*' distinguishes from Tape SAVE) 


6.10.41 


SAVE * "“m", “filespec" 
Saves the current program and variables to the specified file on the 
specified volume. 


SAVE * "m", "filespec" LINE 


Saves the current program and variables to the specified file on the 
specified volume. When it is loaded, it automatically starts at the 
beginning of the program. 


SAVE * "“m", “filespec" LINE linenumber 

Saves the current program and variables to the specified file on the 
specified volume. When it is loaded, it automatically starts at the 
specified linenumber. 


SAVE * "m", "filespec" DATA arrayname () 
Saves the specified numeric data array to the specified file on the 
specified volume. 


SAVE * “m", "filespec" DATA arrayname $() 
Saves the specified string data array to the specified file on the 
specified volume. 


SAVE * "“m", "filespec" CODE start, len 
Saves the byte array starting at address ‘start' for a length of '‘len' 
bytes to the specified file on the specified volume. 


SAVE * "“m", "“filespec" SCREEN$ 
Saves the contents of the screen to the specified file on the 
specified volume. This is equivalent to: 

SAVE * “m", "“filespec" CODE 16384, 6912 


LOAD * (Note: '*' distinguishes from Tape LOAD) 


LOAD * "m", "filespec" 
Loads the current program and variables from the specified file on the 
specified volume. 


LOAD * "“m", “filespec" DATA arrayname () 
Loads the specified numeric data array from the specified file on the 
specified volume. 
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LOAD * "m", “filespec" DATA arrayname $() 
Loads the specified string data array from the specified file on the 
specified volume. 


LOAD * "“m", "filespec" CODE [ start [ , len ee 

Loads the byte array into memory starting at address ‘start' for a 
length of ‘len' bytes from the specified file on the specified volume. 
If either ‘start’ or ‘len' is not specified, the parameters with which 
it was saved are used. 


LOAD * "mm", "“filespec" SCREEN$ 
Loads the contents to the screen from the specified file on the 
specified volume. 


6.10.12 ERASE "“m", "filespec" 
Removes the specified file from the specified volume. See OPEN above for a 
description of "filespec". 


6.10.13 MOVE “m", “old filespec", "new filespec" 

Causes the file on the volume specified in "old filespec" to be renamed with 
"new filespec". If "new filespec" specifies a volume, it must be identical to 
that specified or implied (default) in "old filespec". 


6.10.14 VERIFY * (Note: '*' distinguishes from Tape VERIFY) 

The following commands have the same semantics as the corresponding LOAD 
commands except that the data is not loaded into memory but compared with what 
is already there. An error message is displayed if they are not identical. 


VERIFY "mn" “flespec” 

VERIFY * "m", “filespec" LINE 

VERIFY * “m", "“filespec" LINE linenumber 
VERIFY * "m", “filespec" DATA arrayname () 
VERIFY * "m", "filespec" DATA arrayname $() 
VERIFY * "“m", "filespec" CODE start, len 
VERIFY * "m", "filespec" SCREEN$ 


6.10.15 PRINT #c, -var list 
Causes the variable list to be written to the file opened through stream c. 


6.10.16 INPUT #c, var list 
Causes the variable list to be read from the file opened through stream c. 


6.10.17. MERGE * "m", "filespec" (Note: '*' distinguishes from Tape MERGE) 
Loads the specified file from the specified drive, causing it to be merged 
with the BASIC program which is already in memory. 


Notational Conventions: 


c = stream # volspec = volume 
only 
m = device spec Filename = filename 
only 
[..] = optional item filespec = volume 


name and filename 
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6.11 MASS STORAGE 


The T/S 2000 has been designed with maximum expansion flexibility in mind. To 
support fast mass storage devices, the device and its controller, simply need 
to be placed under the direction and control of a collection of bank switching 
logic. The functions of this logic are described in paragraph 1.3. The 

structure of the expansion Bank in which the mass storage device would reside 


is described in paragraph 1.9.1. 
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SECTION VII 
DEVELOPMENT SYSTEM INTERFACES 
7.1 SPECTRASIDE 
TIMEX will have available a development system interface termed SPECTRASIDE. 


SPECTRASIDE is a software development tool designed to allow developers to 
create programs on their existing development systems and debug the programs 
on the T/S 2000. It is intended to be used by a person knowledgeable in Z-80 
coding and to a limited degree knowledgeable in Z-80 hardware. 


With the SPECTRASIDE system installed on a T/S 2000, memory may be examined 
and modified and machine language programs executed. Programs may be executed 
in real time or single stepped. The 2-80 registers may be examined and 
modified. The hardware break point circuit allows a break point at a RAM or 
ROM location conditionally on instruction fetch, any read, any write or any 
access. Through an external RS-232 port, code may be up-loaded or down-loaded 
to or from a Host Software Development System with programmer interaction 
through the external port or via the T/S 2000 keyboard and display. 
SPECTRASIDE occupies only 128 bytes of memory employing a shadow ROM technique 
and occupies I/0 ports 78H - 7FH. 


SPECTRASIDE installs by plugging a connector onto the back of the T/S 2000. 
Connection to the Host Development System is by a female DB-25 connector with 
the pinout of a RS-232C modem, ready to talk to a terminal device. 


If your development environment is not supported by the system described above 
please contact TIMEX. 
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Bal GUIDELINES FOR SUBMITTED SOFTWARE 


In order to be considered for possible inclusion in the TIMEX Computer product 
software line, the submission of software must adhere to the following 
guidelines. 


All submitted software must be in finished product form. We are interested 
only in looking at what you consider to be the final version of your code. 
After examining your software, TIMEX may recommend that certain changes be 
made to increase the utility or versatility of the program, but jit is expected 
that the initial submission be as bug-free as possible. 


All documentation must be included in the initial submission. The required 
documentation includes: 


1) A signed copy of the condition statement (refer to paragraph 8.2) -- no 
software will be examined until this document has been received. 


2) A completed copy of the software check sheet (refer to paragraph 8.3) -- 
the information on this sheet is vital to our evaluation process. 


3) Instructions to the user -- the instructions for use of a program are as 
important as the code itself. 


Other requirements: 


1) Initial submissions should include one copy of the software. Upon 
acceptance, three copies (on separate cassettes) will be requested. 


2) The program should be able to be readily duplicated to aid in our 
evaluation. 


3) Your copyright notice need not be displayed, but jit must appear somewhere 
in your code. 


4) No software should require that it be loaded via LOAD "(NAME)" CODE. If 
your program consists entirely of machine code, it must be preceded on 
the tape by a BASIC program to LOAD the code: 


19 LOAD "(NAME)" CODE 
29 PRINT USR X 


5) Software should autostart wherever possible. 
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g.2 COPY OF CONDITION FORM 


CONDITIONS FOR EVALUATING PROGRAMS SUBMITTED BY NON-TIMEX 
AUTHORS AND OWNERS FOR THE TIMEX SINCLAIR PERSONAL COMPUTER 


The TIMEX Computer Corporation (hereinafter referred to as “TIMEX") agrees to 
receive and evaluate, upon request, a computer program submitted you, but only 
after you have agreed to the following terms and conditions. 


1. 


You agree to submit a Copy of the computer program entitled 

(Program) to TIMEX for the 
purpose of evaluation for possible marketing and use by TIMEX. You 
represent that you are the owner of and have the unqualified right to make 
the Program available to TIMEX. 


The Program must be the result of your original work or owned by you, must 
be complete and fully operational on TIMEX Sinclair 2000 Series computers, 
and must be sufficiently documented in the English language to permit the 
user to operate the Program without unreasonable difficulty. However, you 
must not send additional Program information or material unless later 
requested by TIMEX. 


Since TIMEX does not wish to receive or hold any voluntarily submitted 
materials in confidence, you understand that TIMEX cannot treat your 
Program as secret or confidential, and no confidential relationship of any 
kind will exist between you and TIMEX as a result of your Program 
submission. TIMEX agrees to only review and evaluate your voluntarily 
submitted Program and to indicate its interest, if any, therein. However, 
TIMEX will use reasonable efforts to avoid any disclosure which might 
prejudice any confidential aspect of the Program. Nevertheless, You must 
protect your proprietary interest in your Program before you disclose it 
to TIMEX. TIMEX will not be liable to you in the event of any disclosure 
by TIMEX unless it is due to the willful and malicious act of TIMEX. 


TIMEX may receive from other sources computer programs that are similar to 
each other and to yours. TIMEX will be free to use, without obligation to 
you, subject to any valid patent and federal copyright rights that you may 
have in your Progra, similar programs and ideas which have been developed 
independently and submitted by others. Also, TIMEX shall be free to use 
similar programs and ideas which become publicly know either before or 
after the submission of your program. 


In the event that TIMEX accepts your submitted program for possible use 
and marketing, you agree that you will enter into a Program Acceptance 
Agreement with TIMEX in the form provided herewith without alternation. 
You understand that even though your program may be accepted and 
subsequent ly marketed by TIMEX, TIMEX cannot make any commitment as to the 
amount of Program sales based on any marketing effort. 
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If following TIMEX's evaluation of your Program it is determined that 
TIMEX has no present or foreseeable future interest therein, such 
conclusion shall be transmitted to you in writing. However, all such 
material submitted in connection with the Program shall be placed in a 
permanent file separated from TIMEX's own internally generated computer 
programs. The Program and all such material submitted therewith is 
retained so that TIMEX will have a record of what was disclosed to it. 


Should any dispute occur between you and TIMEX arising out of or related 
to ‘these Conditions For Evaluating Programs, or your Program submission, 
you agree that Two Thousand Dollars ($2,000) shall be the absolute limit 
of TIMEX liability. 


TIMEX reserves the right at any time, without notice and without 
obligation to terminate its policy of evaluating submitted programs, to 
change the conditions under which programs are submitted, and to stop 
receiving programs from persons outside the TIMEX organization. 


TIMEX cannot be held responsible for any delay in evaluating your Program 
and replying to your submission. Therefore, you should pursue whatever 
course of action would be beneficial to you while waiting for our response 
based on the evaluation of your submitted program. 


This agreement constitutes the entire understanding between you and TIMEX 
with regard to the evaluation of your Program and it applies to TIMEX and 
all of its affiliates and may not be amended or modified except in 
writing, agreed to by both you and duly authorized officers or 
representatives of TIMEX. 


If you wish to submit your computer program to TIMEX on the foregoing 
basis, kindly sign below indicating that you have read and thoroughly 
understand the foregoing and that you agree with each of the various terms 
and conditions stated therein. 


Name: 


Date: 


Mr. George Grimm 
TIMEX Computer Corporation _ 
Waterbury, CT. 06720 Please provide your mailing address 


re 


res 
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8.3 COPY OF CHECK SHEET 


TIMEX COMPUTER CORP. 
NE AN ice 


TEELE: 

a a 
COPYRIGHT: : 

Tp reo a a Ge 
K-RAM: 

Pa a oS 


PROGRAMS : 
SEQUENCE NAME LOAD NAME ; LOAD TIME 


BRIEF PROGRAM DESCRIPTIONS: 


COMMENTS : 
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